Unkey · Example Payload

Unkey Identitieslistidentities Example

APIKeysRate LimitingAuthenticationDeveloper PlatformAccess ControlIdentityAnalytics

Unkey Identitieslistidentities Example is an example object payload from Unkey, with 6 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

operationIdmethodpathsummaryrequestExamplesresponseExamples

Example Payload

{
  "operationId": "identities.listIdentities",
  "method": "POST",
  "path": "/v2/identities.listIdentities",
  "summary": "List Identities",
  "requestExamples": [
    {
      "contentType": "application/json",
      "name": "basic",
      "example": {
        "limit": 50
      }
    },
    {
      "contentType": "application/json",
      "name": "withCursor",
      "example": {
        "cursor": "cursor_eyJrZXkiOiJrZXlfMTIzNCJ9",
        "limit": 50
      }
    }
  ],
  "responseExamples": [
    {
      "status": "200",
      "contentType": "application/json",
      "name": "success",
      "example": {
        "data": {
          "cursor": "cursor_eyJsYXN0SWQiOiJpZF8wMlpZUjNROU5QOEpNNFg4SFdTS1BXNDNKRiJ9",
          "identities": [
            {
              "externalId": "user_123",
              "id": "id_01H9TQP8NP8JN3X8HWSKPW43JE",
              "meta": {
                "name": "Alice Smith",
                "plan": "premium"
              },
              "ratelimits": [
                {
                  "duration": 60000,
                  "limit": 1000,
                  "name": "requests"
                }
              ]
            },
            {
              "externalId": "user_456",
              "id": "id_02ZYR3Q9NP8JM4X8HWSKPW43JF",
              "meta": {
                "name": "Bob Johnson",
                "plan": "basic"
              },
              "ratelimits": [
                {
                  "duration": 60000,
                  "limit": 500,
                  "name": "requests"
                }
              ]
            }
          ],
          "total": 247
        },
        "meta": {
          "requestId": "req_01H9TQPP77V5E48E9SH0BG0ZQX"
        }
      }
    },
    {
      "status": "403",
      "contentType": "application/json",
      "name": "missingPermission",
      "example": {
        "error": {
          "detail": "Your root key requires the 'identity.*.read_identity' permission to perform this operation",
          "status": 403,
          "title": "Forbidden",
          "type": "forbidden"
        },
        "meta": {
          "requestId": "req_0uVwX4yZaAbCdEfGhIjKl"
        }
      }
    }
  ]
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/unkey-identitieslistidentities-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.