> ## 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.

# session.vaultRequests.eligibility

> The brand's default vault, whether the unit can be vaulted into it now, and the request its owner can still cancel with `wallet.cancelVault()` in `@endstate-sdk/web`.

```ts theme={null}
eligibility(options?: RequestOptions): Promise<VaultEligibility>
```

| | |
| - | - |
| Endpoint | [`GET /v1/units/{unit_id}/vault-eligibility`](https://docs.endstate.io/api-reference/vaults/check-whether-a-unit-can-be-vaulted) |
| Credential | Session token (`end_sess_...`) |
| Retry class | `read` |

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

## Example

```ts theme={null}
const result = await session.vaultRequests.eligibility();
```

## Parameters

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

Unit id.

## Returns

`200` - `VaultEligibility`.

**vaultable** `boolean` *required*

Whether the owner can vault the item into `vault` now: the unit is issued, its collection is active, it is not vaulted and has no open vault request, and the vault takes new items. Ownership is checked when the owner approves.

**vault** `object | null` *required*

The brand's default vault, where a vaulted item goes. Null when the brand has none that takes new items.

**request\_id** `string | null` *required*

The item's vault request while its owner can still cancel it, so a page finds it again after a reload. Null when there is none, including once the item is vaulted.

## 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 |
| `session_token.invalid_or_expired` | 401 | Do not retry |
| `session_token.wrong_chip` | 403 | Do not 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.