List files

List previously uploaded files.

GET /files

List uploaded files.

Parameters

Query parameters

Field	Type	Required	Description
`purpose`	string	No	Return only files with this purpose.
`limit`	integer	No	Maximum number of files to return, from 1 to 10,000. Defaults to 10,000.
`order`	enum ('asc', 'desc')	No	Sort direction by `created_at`: `asc` for oldest first, `desc` for newest first.
`after`	string	No	A cursor for use in pagination. `after` is a file ID that defines your place in the list.

Response

HTTP 200 — OK

Content Type: application/json

ListFilesResponse

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.list()
print(response.model_dump_json(indent=2))

python
import json
import os
import requests
response = requests.get(
    "https://api.meta.ai/v1/files",
    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" \
  -H "Authorization: Bearer $MODEL_API_KEY"

For supported file types and how to reference files in requests, see the Files feature page.

List files

List previously uploaded files.

GET /files

List uploaded files.

Parameters

Query parameters

Field	Type	Required	Description
`purpose`	string	No	Return only files with this purpose.
`limit`	integer	No	Maximum number of files to return, from 1 to 10,000. Defaults to 10,000.
`order`	enum ('asc', 'desc')	No	Sort direction by `created_at`: `asc` for oldest first, `desc` for newest first.
`after`	string	No	A cursor for use in pagination. `after` is a file ID that defines your place in the list.

Response

HTTP 200 — OK

Content Type: application/json

ListFilesResponse

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.list()
print(response.model_dump_json(indent=2))

python
import json
import os
import requests
response = requests.get(
    "https://api.meta.ai/v1/files",
    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" \
  -H "Authorization: Bearer $MODEL_API_KEY"

For supported file types and how to reference files in requests, see the Files feature page.

List files

GET /files

Parameters

Query parameters

Response

Content Type: application/json

Please confirm your identity

List files

GET /files

Parameters

Query parameters

Response

Content Type: application/json

Please confirm your identity