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
    Create User Profile
    List User Profiles
    Get User Profile
    Update User Profile
    Create Enrollment URL
    Admin
    Completions
    Create a Text Completion
    Support & configuration
    Rate limitsService tiersVersionsIP addressesSupported regionsOpenAI SDK compatibility
    Console
    Log in

    List User Profiles

    GET/v1/user_profiles

    List User Profiles

    Query ParametersExpand Collapse
    limit: optional number

    Query parameter for limit

    order: optional "asc" or "desc"

    Query parameter for order

    Accepts one of the following:
    "asc"
    "desc"
    page: optional string

    Query parameter for page

    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 19 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"
    "mcp-client-2025-11-20"
    "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"
    "fast-mode-2026-02-01"
    "output-300k-2026-03-24"
    "user-profiles-2026-03-24"
    ReturnsExpand Collapse
    data: array of BetaUserProfile { id, created_at, metadata, 4 more }
    id: string
    created_at: string

    A timestamp in RFC 3339 format

    metadata: map[string]
    trust_grants: map[BetaUserProfileTrustGrant { status } ]
    status: string
    type: string
    updated_at: string

    A timestamp in RFC 3339 format

    external_id: optional string
    next_page: optional string
    List User Profiles
    curl https://api.anthropic.com/v1/user_profiles \
        -H 'anthropic-version: 2023-06-01' \
        -H 'anthropic-beta: user-profiles-2026-03-24' \
        -H "X-Api-Key: $ANTHROPIC_API_KEY"
    Response 200
    {
      "data": [
        {
          "id": "id",
          "created_at": "2019-12-27T18:11:19.117Z",
          "metadata": {
            "foo": "string"
          },
          "trust_grants": {
            "foo": {
              "status": "status"
            }
          },
          "type": "type",
          "updated_at": "2019-12-27T18:11:19.117Z",
          "external_id": "external_id"
        }
      ],
      "next_page": "next_page"
    }
    Returns Examples
    Response 200
    {
      "data": [
        {
          "id": "id",
          "created_at": "2019-12-27T18:11:19.117Z",
          "metadata": {
            "foo": "string"
          },
          "trust_grants": {
            "foo": {
              "status": "status"
            }
          },
          "type": "type",
          "updated_at": "2019-12-27T18:11:19.117Z",
          "external_id": "external_id"
        }
      ],
      "next_page": "next_page"
    }

    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