Retrieve a file
Retrieve metadata for a previously uploaded file by its ID.
GET /files/{file_id}
Retrieve metadata for an uploaded file.
Parameters
Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
file_id | string | Yes | Identifier of the file to act on. |
Response
HTTP 200: OK
Content Type: application/json
python
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.meta.ai/v1",
api_key=os.environ["MODEL_API_KEY"],
)
response = client.files.retrieve("file_abc123")
print(response.model_dump_json(indent=2))import json
import os
import requests
response = requests.get(
"https://api.meta.ai/v1/files/file_abc123",
headers={"Authorization": f"Bearer {os.environ['MODEL_API_KEY']}"},
)
response.raise_for_status()
print(json.dumps(response.json(), indent=2))curl -X GET "https://api.meta.ai/v1/files/file_abc123" \
-H "Authorization: Bearer $MODEL_API_KEY"To download the file's contents, see Retrieve file content.
Mirrored from dev.meta.ai/docs/api-reference/files/retrieve-file (synced Oct 30, 2026). Text and examples © Meta. Live demos run on Muse Muse's key.