---
title: "GET /vault/credential-requests"
method: GET
path: "/vault/credential-requests"
---

# GET /vault/credential-requests

`GET /vault/credential-requests`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/vault/credential-requests`
- 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)
- `agentId` union: Agent identifier. Optional when using an agent API key (resolved automatically); required when using a master key.
  - string
  - string
- `status` 'PENDING' | 'FULFILLED' | 'EXPIRED' | 'DECLINED' | 'CANCELLED': Filter by lifecycle status

## Response `200`

OK

- object: Paginated credential requests
  - `items` object[], required: Credential requests, newest first
    - `requestId` string, required: Credential request identifier
    - `agentId` string, required: Agent the credential was requested for
    - `type` 'login' | 'secure_note' | 'card' | 'identity' | 'oauth_token' | 'api_key' | 'certificate', required: Credential type being collected
    - `name` string, required: Display name the agent chose
    - `reason` string, required: Why the agent asked — shown to the owner
    - `status` 'PENDING' | 'FULFILLED' | 'EXPIRED' | 'DECLINED' | 'CANCELLED', required: Lifecycle status (lazy-expired)
    - `fillUrl` string, nullable, required: Token-gated fill URL — present only while PENDING
    - `credentialId` string, nullable, required: Vault credential reference once FULFILLED
    - `expiresAt` string, date-time, required: When the request stops accepting a fill
    - `createdAt` string, date-time, required: When the agent created the request
  - `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)