Skip to navigation
business.me-mate.net APIs Document V 1.0Messenger Mate Gallery App File Upload Folder Management APIFile Upload Ap Is

Get Single File

View as Markdown

Get Single File

Retrieves the details of a specific file using its ID.

Method: GET
URL: {{base_url}}/files/{{file_id}}

Authentication

This endpoint requires authentication.

  • Recommended: Bearer token in the Authorization header:
Authorization: Bearer {{access_token}}

Notes:

  • If your collection/folder already sets auth, this request can inherit auth.

  • Ensure {{access_token}} is a valid, non-expired token.

Required variables

Set these variables at the environment or collection level:

VariableRequiredDescription
base_urlYesBase API URL (e.g. https://business.me-mate.net/partners/wp-gallery/manage)
access_tokenYesAccess token used to authorize the request
file_idYesID of the file to retrieve

Path Parameters

ParameterTypeRequiredDescription
file_idintegerYesUnique identifier of the file

Example request URL:

{{base_url}}/files/34

Sample request

curl --request GET "{{base_url}}/files/{{file_id}}" \
  --header "Authorization: Bearer {{access_token}}"

Sample success response

A successful request typically returns HTTP 200 OK and a JSON response.

{
  "success": true,
  "data": {
    "id": 34,
    "user_id": "43028",
    "folder_id": 10,
    "name": "Frame 1000003420.png",
    "original_name": "Frame 1000003420.png",
    "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/MEL37P9ilmLodrQg.png",
    "hash": "b302a431204139c0572ab43b0d2bbc71297e8e1c21445d8daa786126de2d1cb1",
    "path_hash": null,
    "mime_type": "image/png",
    "type": "image",
    "extension": "png",
    "size": 87963,
    "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/MEL37P9ilmLodrQg.png",
    "is_starred": false,
    "is_whatsapp_compatible": true,
    "whatsapp_compatibility_reason": "Ready for WhatsApp",
    "uploaded_at": "2026-03-10T04:37:27.000000Z",
    "created_at": "2026-03-10T04:37:27.000000Z",
    "updated_at": "2026-03-10T04:37:27.000000Z",
    "deleted_at": null,
    "tags": [],
    "folder": {
      "id": 10,
      "user_id": "43028",
      "name": "test2",
      "parent_id": 9,
      "is_system": false,
      "file_count": 14,
      "created_at": "2026-03-09T13:10:07.000000Z",
      "updated_at": "2026-03-10T05:34:50.000000Z",
      "deleted_at": null
    }
  }
}

Common errors

  • 400 Bad Request

    • Invalid or missing file_id

  • 401 Unauthorized / 403 Forbidden

    • Missing/invalid Authorization header

    • Expired {{access_token}}

  • 404 Not Found

    • File with the given file_id does not exist

Notes

  • This endpoint returns file metadata and its public URL.

  • The url field can be used directly for preview, download, or sending the file in integrations such as WhatsApp.

Response

OK
dataobject
successboolean