---
title: "GET /vault/credential-requests/{requestId}"
method: GET
path: "/vault/credential-requests/{requestId}"
---

# GET /vault/credential-requests/{requestId}

`GET /vault/credential-requests/{requestId}`

## Request

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

## Path parameters

- `requestId` string, required: Credential request identifier

## Response `200`

OK

- object: Current status of a credential request, polled by the agent until FULFILLED
  - `status` 'PENDING' | 'FULFILLED' | 'EXPIRED' | 'DECLINED' | 'CANCELLED', required: Current request status
  - `credentialId` string, nullable, required: Vault credential ID — set once the request is FULFILLED, null otherwise
  - `maskedPreview` string, nullable, required: Masked preview of the submitted secret (e.g. ****1234) so the agent can confirm which credential arrived without seeing it; null until FULFILLED

---

[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)
