Claude Platform Docs

List Files

files.list(FileListParams**kwargs) -> SyncPageCursor[FileMetadata]
GET/v1/files

List Files

Parameters
ids: Optional[Sequence[str]]

Restrict the result set to Files whose id is in this list. At most 100 entries (after de-duplication). Mutually exclusive with page and limit. When supplied, the response is always a single page (next_page is null). IDs that do not resolve to a visible File — including deleted Files — are silently omitted.

limit: Optional[int]

Number of items to return per page.

Defaults to 20. Ranges from 1 to 1000.

default20
maximum1000
minimum1
page: Optional[str]

Opaque page cursor returned in a prior list response's next_page. Prefixed page_.

Returns
class FileMetadata: …
id: str

Unique object identifier.

The format and length of IDs may change over time.

created_at: datetime

RFC 3339 datetime string representing when the file was created.

formatdate-time
filename: str

Original filename of the uploaded file.

maxLength500
minLength1
mime_type: str

MIME type of the file.

maxLength255
minLength1
size_bytes: int

Size of the file in bytes.

minimum0
type: Literal["file"]

Object type.

For files, this is always "file".

downloadable: Optional[bool]

Whether the file can be downloaded.

defaultfalse
expires_at: Optional[datetime]

RFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with expires_in_seconds, this is the upload time plus that value.

formatdate-time

List Files

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get(
        "ANTHROPIC_API_KEY"
    ),  # This is the default and can be omitted
)
page = client.files.list()
page = page.data[0]
print(page.id)
{
  "data": [
    {
      "id": "file_011CNha8iCJcU1wXNR6q4V8w",
      "created_at": "2025-04-15T18:37:24.100435Z",
      "filename": "document.pdf",
      "mime_type": "application/pdf",
      "size_bytes": 102400,
      "type": "file",
      "downloadable": false,
      "expires_at": "2025-05-15T18:37:24.100435Z"
    }
  ],
  "next_page": "next_page"
}
Returns Examples
{
  "data": [
    {
      "id": "file_011CNha8iCJcU1wXNR6q4V8w",
      "created_at": "2025-04-15T18:37:24.100435Z",
      "filename": "document.pdf",
      "mime_type": "application/pdf",
      "size_bytes": 102400,
      "type": "file",
      "downloadable": false,
      "expires_at": "2025-05-15T18:37:24.100435Z"
    }
  ],
  "next_page": "next_page"
}