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

# Vaults

<Info>
  **Pre-release** — contact your Fortary account team for access.
</Info>

A vault is the container Fortary custody is organized around: your organization's assets are held in vaults, and the v1 API reads everything — balances, transaction history, deposit addresses — through the vault that holds it.

## Vault identity

Vaults are identified by opaque, prefixed IDs such as `vault_3f8a2c1d9b`. Treat them as opaque — don't parse or construct them; store and pass back the exact string you received. See [Identifiers & data formats](/api/concepts/identifiers).

Start with [List vaults](/api/reference/list-vaults) to discover the vaults your credential can access and their IDs; every other vault operation takes one of those IDs in its path.

## What a credential can see

A credential sees a vault only where its `vault:read` scope, its owner's live **Developer** role, and its vault allowlist all agree — see [Authorization](/api/concepts/authorization). A vault outside that intersection returns `404`, never `403`, so responses never reveal whether a vault you can't see exists.

## Operations

| Operation                                                         | Path                                    | Description                               |
| ----------------------------------------------------------------- | --------------------------------------- | ----------------------------------------- |
| [List vaults](/api/reference/list-vaults)                         | `GET /v1/vaults`                        | List the vaults the credential can access |
| [Get vault](/api/reference/get-vault)                             | `GET /v1/vaults/{vaultId}`              | Retrieve a single vault                   |
| [Get vault balances](/api/reference/get-vault-balances)           | `GET /v1/vaults/{vaultId}/balances`     | List a vault's asset balances             |
| [List vault transactions](/api/reference/list-vault-transactions) | `GET /v1/vaults/{vaultId}/transactions` | List a vault's transaction history        |
| [List vault addresses](/api/reference/list-vault-addresses)       | `GET /v1/vaults/{vaultId}/addresses`    | List a vault's deposit addresses          |