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: `asc` for oldest first, `desc` for newest first. Files are ordered by when each was added, which can differ from `created_at`, so neighboring `created_at` values are not always in order.
`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))

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

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.

Mirrored from dev.meta.ai/docs/api-reference/files/list-files (synced Oct 30, 2026). Text and examples © Meta. Live demos run on Muse Muse's key.