GET
/
v1
/
identities.getIdentity
Get identity
curl --request GET \
  --url https://api.unkey.dev/v1/identities.getIdentity \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "externalId": "<string>",
  "meta": {},
  "ratelimits": [
    {
      "name": "tokens",
      "limit": 10,
      "duration": 1000
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
identityId
string

The id of the identity to fetch, use either identityId or externalId, if both are provided, identityId takes precedence.

Minimum length: 1
Example:

"id_1234"

​
externalId
string

The externalId of the identity to fetch, use either identityId or externalId, if both are provided, identityId takes precedence.

Minimum length: 1
Example:

"id_1234"

Response

The configuration for an api

​
id
string
required

The id of this identity. Used to interact with unkey's API

​
externalId
string
required

The id in your system

​
meta
object
required

The meta object defined for this identity.

​
ratelimits
object[]
required

When verifying keys, you can specify which limits you want to use and all keys attached to this identity, will share the limits.