Get File Metadata

FileMetadata Beta.Files.RetrieveMetadata(, )

GET/v1/files/{file_id}

Get File Metadata

ParametersExpand Collapse

FileRetrieveMetadataParams parameters

required string fileID

ID of the File.

IReadOnlyList<AnthropicBeta> betas

Optional header to specify the beta version(s) you want to use.

ReturnsExpand Collapse

class FileMetadata:

required string ID

Unique object identifier.

The format and length of IDs may change over time.

required DateTimeOffset CreatedAt

RFC 3339 datetime string representing when the file was created.

required string Filename

Original filename of the uploaded file.

required string MimeType

MIME type of the file.

required Long SizeBytes

Size of the file in bytes.

JsonElement Type

Object type.

For files, this is always "file".

Boolean Downloadable

Whether the file can be downloaded.

Get File Metadata

FileRetrieveMetadataParams parameters = new() { FileID = "file_id" };

var fileMetadata = await client.Beta.Files.RetrieveMetadata(parameters);

Console.WriteLine(fileMetadata);

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
}

Returns Examples

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
}

Get File Metadata

FileMetadata Beta.Files.RetrieveMetadata(, )

GET/v1/files/{file_id}

Get File Metadata

ParametersExpand Collapse

FileRetrieveMetadataParams parameters

required string fileID

ID of the File.

IReadOnlyList<AnthropicBeta> betas

Optional header to specify the beta version(s) you want to use.

ReturnsExpand Collapse

class FileMetadata:

required string ID

Unique object identifier.

The format and length of IDs may change over time.

required DateTimeOffset CreatedAt

RFC 3339 datetime string representing when the file was created.

required string Filename

Original filename of the uploaded file.

required string MimeType

MIME type of the file.

required Long SizeBytes

Size of the file in bytes.

JsonElement Type

Object type.

For files, this is always "file".

Boolean Downloadable

Whether the file can be downloaded.

Get File Metadata

FileRetrieveMetadataParams parameters = new() { FileID = "file_id" };

var fileMetadata = await client.Beta.Files.RetrieveMetadata(parameters);

Console.WriteLine(fileMetadata);

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
}

Returns Examples

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
}