UNunkeyed
identities

List Identities

Changed on

Get a paginated list of all identities in your workspace. Returns metadata and rate limit configurations.

Perfect for building management dashboards, auditing configurations, or browsing your identities.

Important Requires identity.*.read_identity permission

post/v2/identities.listIdentities

Request

  • Base URL
    https://api.unkey.com
  • URL
    https://api.unkey.com/v2/identities.listIdentities
  • Auth
    HTTP bearer

Request body

limitinteger

The maximum number of identities to return in a single request. Use this to control response size and loading performance.

cursorstring

Pagination cursor from a previous response. Use this to fetch subsequent pages of results when the response contains a cursor value.

searchstring

Free-form text to filter identities. Returns identities whose ID or external ID contains the search string. Matching is case-insensitive.

Example request

{
  "limit": 50,
  "cursor": "cursor_eyJrZXkiOiJrZXlfMTIzNCJ9",
  "search": "user_123"
}

Response

Successfully retrieved the list of identities

Example response

{
  "meta": {
    "requestId": "req_123"
  },
  "data": [
    {
      "ratelimits": [
        {
          "id": "rl_1234567890abcdef",
          "name": "api_requests",
          "limit": 1000,
          "duration": 3600000,
          "autoApply": true
        }
      ]
    }
  ],
  "pagination": {
    "cursor": "eyJrZXkiOiJrZXlfMTIzNCIsInRzIjoxNjk5Mzc4ODAwfQ==",
    "hasMore": true
  }
}

Changes