curl -X GET 'https://api.anthropic.com/v1/user_profiles?beta=true&limit=10&page=example-page&order=asc&order_by=created_at' \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H 'anthropic-version: 2023-06-01'

# GET /v1/user_profiles?beta=true (Claude API)
Base URL: https://api.anthropic.com
Auth: x-api-key; Anthropic API key; required.
Status: Beta.
Last verified: 2026-10-20

> List User Profiles

## Critical Gotchas
* Authentication uses the `x-api-key` header and requests also require an `anthropic-version` header.
* The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.

## cURL
curl -X GET 'https://api.anthropic.com/v1/user_profiles?beta=true&limit=10&page=example-page&order=asc&order_by=created_at' \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H 'anthropic-version: 2023-06-01'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| limit | query | integer | No | Query parameter for limit |
| page | query | string | No | Query parameter for page |
| order | query | string | No | Query parameter for order |
| order_by | query | string | No | Query parameter for order_by |

## Response example
{"data":[{}],"next_page":"page_MjAyNS0wNS0xNFQwMDowMDowMFo="}

---
Need an API key? Get one at https://console.anthropic.com/settings/keys

GET

GET /v1/user_profiles?beta=true — Claude API

Beta

Anthropic API key (required); https://api.anthropic.com

Claude API

List User Profiles

Base URL: https://api.anthropic.com
Auth: x-api-key: <ANTHROPIC_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 218 tokens · Vary: Accept

Critical gotchas

Authentication uses the x-api-key header and requests also require an anthropic-version header.

The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.

cURL

curl -X GET 'https://api.anthropic.com/v1/user_profiles?beta=true&limit=10&page=example-page&order=asc&order_by=created_at' \  -H "x-api-key: $ANTHROPIC_API_KEY" \  -H 'anthropic-version: 2023-06-01'

Parameters

Name	In	Type	Required	Description
limit	query	integer	No	Query parameter for limit
page	query	string	No	Query parameter for page
order	query	string	No	Query parameter for order
order_by	query	string	No	Query parameter for order_by

Response 200 OK

{
  "data": [
    {
      "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
      "type": "user_profile",
      "external_id": "user_12345",
      "name": "Example User",
      "access_type": "application",
      "trust_grants": {
        "cyber": {
          "status": "active"
        }
      },
      "external_user_onboarded_at": "2024-11-02T08:15:00Z",
      "metadata": {},
      "created_at": "2026-03-15T10:00:00Z",
      "updated_at": "2026-03-15T10:00:00Z"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

Get a free Claude API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.