---
title: "GET /vault/identities"
method: GET
path: "/vault/identities"
---

# GET /vault/identities

`GET /vault/identities`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/vault/identities`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `cursor` string: Opaque cursor from a previous response to fetch the next page
- `limit` integer: Maximum number of items to return per page (1–100, default 20)
- `status` 'ACTIVE' | 'LOCKED' | 'ERROR': Filter vault identities by status
- `query` string: Free-text search over the owning agent's name and slug

## Response `200`

OK

- object: Paginated list of vault identities for an organization
  - `items` object[], required: List of vault identities with agent information
    - `id` string, required: Unique vault record identifier
    - `agentId` string, required: Agent the vault belongs to
    - `orgId` string, required: Organization the vault belongs to
    - `vaultUserId` string, nullable, required: Vault backend user identifier
    - `vaultOrgId` string, nullable, required: Vault backend organization identifier
    - `collectionId` string, nullable, required: Default collection identifier in the vault
    - `status` 'ACTIVE' | 'LOCKED' | 'ERROR', required: Current vault operational status
    - `credentialCount` integer, required: Total number of credentials stored
    - `lastSyncAt` string, date-time, nullable, required: Timestamp of the last vault synchronization
    - `createdAt` string, date-time, required: Timestamp when the vault was provisioned
    - `updatedAt` string, date-time, required: Timestamp when the vault was last updated
    - `agentName` string, required: Name of the agent that owns the vault
    - `agentSlug` string, required: Slug of the agent that owns the vault
  - `pagination` object, required: Cursor-based pagination metadata
    - `nextCursor` string, nullable, required: Cursor to pass as the `cursor` parameter to retrieve the next page, or null if no more results
    - `hasMore` boolean, required: Whether additional pages of results are available

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)