Loading...
    • Developer Guide
    • API Reference
    • MCP
    • Resources
    • Release Notes
    Search...
    ⌘K

    Using the API

    OverviewClient SDKsBeta headersErrors
    Messages
    Create a Message
    Count tokens in a Message
    Batches
    Create a Message Batch
    Retrieve a Message Batch
    List Message Batches
    Cancel a Message Batch
    Delete a Message Batch
    Retrieve Message Batch results
    Models
    List Models
    Get a Model
    Beta
    Models
    List Models
    Get a Model
    Messages
    Create a Message
    Count tokens in a Message
    Batches
    Create a Message Batch
    Retrieve a Message Batch
    List Message Batches
    Cancel a Message Batch
    Delete a Message Batch
    Retrieve Message Batch results
    Files
    Upload File
    List Files
    Download File
    Get File Metadata
    Delete File
    Skills
    Create Skill
    List Skills
    Get Skill
    Delete Skill
    Versions
    Create Skill Version
    List Skill Versions
    Get Skill Version
    Delete Skill Version
    Admin
    Organization
    Get Organization Me
    Invites
    Create Invite
    List Invites
    Get Invite
    Delete Invite
    Users
    Get User
    Update User
    Remove User
    List Users
    Workspaces
    Get Workspace
    List Workspaces
    Create Workspace
    Update Workspace
    Archive Workspace
    Members
    Get Workspace Member
    Create Workspace Member
    Delete Workspace Member
    List Workspace Members
    Update Workspace Member
    API Keys
    Get Api Key
    Update Api Key
    List Api Keys
    Usage And Cost
    Usage Report
    Get Messages Usage Report
    Get Claude Code Usage Report
    Cost Report
    Get Cost Report
    Completions
    Create a Text Completion

    Support & configuration

    Rate limitsService tiersVersionsIP addressesSupported regionsOpenAI SDK compatibility
    Console
    List Files
    get/v1/files?beta=true

    List Files

    Query ParametersExpand Collapse
    after_id: optional string

    ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.

    before_id: optional string

    ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.

    limit: optional number

    Number of items to return per page.

    Defaults to 20. Ranges from 1 to 1000.

    maximum1000
    minimum1
    Header ParametersExpand Collapse
    "anthropic-beta": optional array of AnthropicBeta

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

    Accepts one of the following:
    UnionMember0 = string
    UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 15 more
    Accepts one of the following:
    "message-batches-2024-09-24"
    "prompt-caching-2024-07-31"
    "computer-use-2024-10-22"
    "computer-use-2025-01-24"
    "pdfs-2024-09-25"
    "token-counting-2024-11-01"
    "token-efficient-tools-2025-02-19"
    "output-128k-2025-02-19"
    "files-api-2025-04-14"
    "mcp-client-2025-04-04"
    "dev-full-thinking-2025-05-14"
    "interleaved-thinking-2025-05-14"
    "code-execution-2025-05-22"
    "extended-cache-ttl-2025-04-11"
    "context-1m-2025-08-07"
    "context-management-2025-06-27"
    "model-context-window-exceeded-2025-08-26"
    "skills-2025-10-02"
    ReturnsExpand Collapse
    data: array of FileMetadata { id, created_at, filename, 4 more }

    List of file metadata objects.

    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.

    formatdate-time
    filename: string

    Original filename of the uploaded file.

    maxLength500
    minLength1
    mime_type: string

    MIME type of the file.

    maxLength255
    minLength1
    size_bytes: number

    Size of the file in bytes.

    minimum0
    type: "file"

    Object type.

    For files, this is always "file".

    Accepts one of the following:
    "file"
    downloadable: optional boolean

    Whether the file can be downloaded.

    first_id: optional string

    ID of the first file in this page of results.

    has_more: optional boolean

    Whether there are more results available.

    last_id: optional string

    ID of the last file in this page of results.

    List Files
    cURL
    curl https://api.anthropic.com/v1/files?beta=true \
        -H "X-Api-Key: $ANTHROPIC_API_KEY"
    {
      "data": [
        {
          "id": "id",
          "created_at": "2019-12-27T18:11:19.117Z",
          "filename": "x",
          "mime_type": "x",
          "size_bytes": 0,
          "type": "file",
          "downloadable": true
        }
      ],
      "first_id": "first_id",
      "has_more": true,
      "last_id": "last_id"
    }
    Returns Examples
    {
      "data": [
        {
          "id": "id",
          "created_at": "2019-12-27T18:11:19.117Z",
          "filename": "x",
          "mime_type": "x",
          "size_bytes": 0,
          "type": "file",
          "downloadable": true
        }
      ],
      "first_id": "first_id",
      "has_more": true,
      "last_id": "last_id"
    }
    © 2025 ANTHROPIC PBC

    Products

    • Claude
    • Claude Code
    • Max plan
    • Team plan
    • Enterprise plan
    • Download app
    • Pricing
    • Log in

    Features

    • Claude and Slack
    • Claude in Excel

    Models

    • Opus
    • Sonnet
    • Haiku

    Solutions

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

    Claude Developer Platform

    • Overview
    • Developer docs
    • Pricing
    • Amazon Bedrock
    • Google Cloud’s Vertex AI
    • Console login

    Learn

    • Blog
    • Catalog
    • Courses
    • 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

    Help and security

    • Availability
    • Status
    • Support center

    Terms and policies

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

    Products

    • Claude
    • Claude Code
    • Max plan
    • Team plan
    • Enterprise plan
    • Download app
    • Pricing
    • Log in

    Features

    • Claude and Slack
    • Claude in Excel

    Models

    • Opus
    • Sonnet
    • Haiku

    Solutions

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

    Claude Developer Platform

    • Overview
    • Developer docs
    • Pricing
    • Amazon Bedrock
    • Google Cloud’s Vertex AI
    • Console login

    Learn

    • Blog
    • Catalog
    • Courses
    • 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

    Help and security

    • Availability
    • Status
    • Support center

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    © 2025 ANTHROPIC PBC