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

FileObject

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))

python
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))

shell
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.

Retrieve a file

GET /files/{file_id}

Parameters

Path parameters

Response

Content Type: application/json

Please confirm your identity

Retrieve a file

GET /files/{file_id}

Parameters

Path parameters

Response

Content Type: application/json

Please confirm your identity