Loading...
    • Developer Guide
    • API Reference
    • MCP
    • Resources
    • Release Notes
    Search...
    ⌘K
    Using the API
    API overviewBeta headersErrors
    Messages
    Create a Message
    Count tokens in a Message
    Models
    List Models
    Get a Model
    Beta
    Upload File
    List Files
    Download File
    Get File Metadata
    Delete File
    Admin
    Completions
    Create a Text Completion
    Support & configuration
    Rate limitsService tiersVersionsIP addressesSupported regionsOpenAI SDK compatibility
    Console
    Log in

    Get File Metadata

    FileMetadata Beta.Files.RetrieveMetadata(FileRetrieveMetadataParamsparameters, CancellationTokencancellationToken = default)
    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.

    "message-batches-2024-09-24"MessageBatches2024_09_24
    "prompt-caching-2024-07-31"PromptCaching2024_07_31
    "computer-use-2024-10-22"ComputerUse2024_10_22
    "computer-use-2025-01-24"ComputerUse2025_01_24
    "pdfs-2024-09-25"Pdfs2024_09_25
    "token-counting-2024-11-01"TokenCounting2024_11_01
    "token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19
    "output-128k-2025-02-19"Output128k2025_02_19
    "files-api-2025-04-14"FilesApi2025_04_14
    "mcp-client-2025-04-04"McpClient2025_04_04
    "mcp-client-2025-11-20"McpClient2025_11_20
    "dev-full-thinking-2025-05-14"DevFullThinking2025_05_14
    "interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14
    "code-execution-2025-05-22"CodeExecution2025_05_22
    "extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11
    "context-1m-2025-08-07"Context1m2025_08_07
    "context-management-2025-06-27"ContextManagement2025_06_27
    "model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26
    "skills-2025-10-02"Skills2025_10_02
    "fast-mode-2026-02-01"FastMode2026_02_01
    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 "file"constant

    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": "id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "filename": "x",
      "mime_type": "x",
      "size_bytes": 0,
      "type": "file",
      "downloadable": true
    }
    Returns Examples
    Response 200
    {
      "id": "id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "filename": "x",
      "mime_type": "x",
      "size_bytes": 0,
      "type": "file",
      "downloadable": true
    }

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy