GET List Identities

List your saved identities and their credentials, or fetch a single identity by ID

GEThttps://api.anakin.io/v1/holocron/identities

GEThttps://api.anakin.io/v1/holocron/identities/{id}

Returns the authenticated user's identities and their attached credentials. Use the returned credentials[].id as the credential_id when submitting authenticated tasks via POST /v1/holocron/task.

An identity is a named container tied to one website (e.g. "Personal Amazon"). Each identity can have multiple credentials of different types: browser_state, credentials, api_key, or token.

This page covers two endpoints:

GET /v1/holocron/identities — list all your identities (paginated by catalog_id)
GET /v1/holocron/identities/\{id\} — fetch a single identity by ID (returns the same identity object, just one of them)

Query Parameters (list endpoint only)

Parameter	Type	Description
`catalog_id`	string	Filter identities to a single website catalog (optional)

Path Parameters (single endpoint only)

Parameter	Type	Description
`id` required	string (UUID)	Identity ID

Response (list)

200 OK

{
  "status": "ok",
  "identities": [
    {
      "id": "7c3f1a2b-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
      "catalog_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Personal Amazon",
      "is_default": true,
      "created_at": "2026-04-15T10:00:00Z",
      "credentials": [
        {
          "id": "11111111-2222-3333-4444-555555555555",
          "identity_id": "7c3f1a2b-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
          "credential_type": "browser_state",
          "status": "active",
          "last_used_at": "2026-04-20T12:34:56Z",
          "created_at": "2026-04-15T10:00:00Z"
        }
      ]
    }
  ]
}

Field	Type	Description
`identities[].id`	string (UUID)	Identity ID
`identities[].catalog_id`	string (UUID)	The catalog (website) this identity belongs to
`identities[].name`	string	User-given name (unique per user + catalog)
`identities[].is_default`	boolean	Marked as the user's default for this catalog
`credentials[].id`	string (UUID)	Use this as `credential_id` in task requests
`credentials[].credential_type`	string	One of: `browser_state`, `credentials`, `api_key`, `token`
`credentials[].status`	string	`active` or `expired` — only `active` credentials can be used

The encrypted credential data is never returned in the response.

Response (single — `GET /identities/\{id\}`)

Same shape as a single element of the identities[] array above, returned at the top level:

{
  "status": "ok",
  "identity": {
    "id": "7c3f1a2b-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
    "catalog_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Personal Amazon",
    "is_default": true,
    "created_at": "2026-04-15T10:00:00Z",
    "credentials": [ /* same shape */ ]
  }
}

Returns 404 Not Found if the identity doesn't exist or doesn't belong to you.

Code Examples

curl https://api.anakin.io/v1/holocron/identities \
  -H "X-API-Key: your_api_key"

import requests

response = requests.get(
    'https://api.anakin.io/v1/holocron/identities',
    headers={'X-API-Key': 'your_api_key'}
)

for identity in response.json()['identities']:
    print(f"{identity['name']}:")
    for cred in identity.get('credentials', []):
        print(f"  {cred['credential_type']} → {cred['id']}")

const response = await fetch('https://api.anakin.io/v1/holocron/identities', {
  headers: { 'X-API-Key': 'your_api_key' }
});

const { identities } = await response.json();
for (const identity of identities) {
  console.log(`${identity.name}:`);
  for (const cred of identity.credentials || []) {
    console.log(`  ${cred.credential_type} → ${cred.id}`);
  }
}

Managing identities via UI

You can also view and copy credential IDs from the Identities dashboard — hover over a credential pill to reveal a copy button.