Get File Metadata

GET /v1/files/\{file_id\}

Get File Metadata

Path parameters

• file_id: string

  ID of the File.

Headers

• "anthropic-workspace-id": optional string

Returns

• FileMetadata object

  • type: "file"

    Object type.

    For files, this is always "file".

  • id: string

    Unique object identifier.

    The format and length of IDs may change over time.

  • created_at: string

    RFC 3339 datetime string representing when the file was created.

    format: date-time

  • filename: string

    Original filename of the uploaded file.

    maxLength: 500, minLength: 1

  • mime_type: string

    MIME type of the file.

    maxLength: 255, minLength: 1

  • size_bytes: number

    Size of the file in bytes.

    minimum: 0

  • downloadable: optional boolean

    Whether the file can be downloaded.

    default: false

  • expires_at: optional string or null

    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.

    format: date-time

Example

curl https://api.anthropic.com/v1/files/$FILE_ID \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response (200)

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