Get File Metadata

files.retrieve_metadata() -> FileMetadata

GET/v1/files/{file_id}

Get File Metadata

Parameters

file_id: str

ID of the File.

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

Get File Metadata

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get(
        "ANTHROPIC_API_KEY"
    ),  # This is the default and can be omitted
)
file_metadata = client.files.retrieve_metadata(
    "file_id",
)
print(file_metadata.id)

{
  "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"
}

Returns Examples

{
  "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"
}