> ## Documentation Index
> Fetch the complete documentation index at: https://docs.endstate.io/llms.txt
> Use this file to discover all available pages before exploring further.

# endstate.vaultRequests.list

> A unit's vault requests, oldest first; the one that reads `active`, `unvault_waiting` or `unvaulting` is the item's current stay in a vault.

```ts theme={null}
list(unitId: string, query?: VaultRequestsListParams, options?: RequestOptions): Paginated<VaultRequest, VaultRequestList>
```

| | |
| - | - |
| Endpoint | [`GET /v1/units/{unit_id}/vault-requests`](https://docs.endstate.io/api-reference/vaults/list-a-units-vault-requests) |
| Credential | Secret key (`end_sk_...`) |
| Retry class | `read` |

Retried on network failure, timeout, `429`, and `5xx`.

## Example

```ts theme={null}
const result = await endstate.vaultRequests.list(unit.id);
```

## Parameters

**unit\_id** `string` *required*

Unit id.

**limit** `integer`

Maximum number of records to return. Defaults to 50; maximum 100.

**cursor** `string`

Opaque cursor from the previous page.

**status** `'pending' | 'submitted' | 'active' | 'unvault_waiting' | 'unvaulting' | 'unvaulted' | 'cancelled' | 'expired' | 'rejected' | 'failed'`

Filter to requests with this status.

## Returns

`200` - `VaultRequestList`.

**vault\_requests** `object[]` *required*

**pagination** `object` *required*

## Errors

Branch on `error.code`, never on the HTTP status - several codes share one.

| Code | HTTP | Retry |
| - | - | - |
| `auth.forbidden` | 403 | Do not retry |
| `auth.unauthorized` | 401 | Do not retry |
| `internal.error` | 500 | Safe to retry |
| `not_found.resource` | 404 | Do not retry |
| `rate_limit.exceeded` | 429 | Safe to retry |
| `unit.not_found` | 404 | Do not retry |
| `validation.failed` | 400 | Do not retry |

See [Errors and retries](https://docs.endstate.io/sdks/core/errors-and-retries.md) for the error types and how to narrow them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.