Get Single File
## 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:
``` http
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:
| Variable | Required | Description |
| --- | --- | --- |
| `base_url` | Yes | Base API URL (e.g. `https://business.me-mate.net/partners/wp-gallery/manage`) |
| `access_token` | Yes | Access token used to authorize the request |
| `file_id` | Yes | ID of the file to retrieve |
---
## Path Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `file_id` | integer | Yes | Unique identifier of the file |
Example request URL:
```
{{base_url}}/files/34
```
---
## Sample request
``` bash
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.
``` json
{
"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
data
success
