---
title: "List Vault Addresses"
method: GET
path: "/api/v1/vaults/{id}/addresses"
tags: ["Vaults"]
---

# List Vault Addresses

`GET /api/v1/vaults/{id}/addresses`

Get a list of all addresses in a vault.

## Path parameters

- `id` string, uuid, required — ID of the vault.

## Query parameters

- `sort_by` VaultAddressSortableFields[]
- `page` integer — The page number to fetch.
- `size` integer — The number of items per page.
- `skip_count` boolean — Whether to skip counting the total number of items.
- `search` string
- `addresses` string[] — List of addresses to filter on.
- `address_types` UtxoAddressType[] — List of address types to filter on.

## Response `200`

Successful Response

- ListVaultAddressesResponse
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `addresses` UtxoVaultAddress[], required
    - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
    - `created_at` string, date-time, required — The date and time when the object was created.
    - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
    - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform
      - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform.
      - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to.
      - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to.
      - `name` string, required — The name of the vault.
      - `address` string — The address of the vault.
      - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required
      - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required
      - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults.
      - `end_user` EndUserRef
        - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
        - `user_type` 'end_user', required — The type of the user.
        - `external_id` string, required — External id of the user.
        - `state` 'active' | 'deleted', required — The state of the user.
      - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer).
    - `name` string, required — The name of the address.
    - `balances` Balances — The cryptocurrency balances of the asset.
      - `total_mined` string, required — The value of all mined assets.
      - `total_pending_incoming` string, required — The value of all pending incoming assets.
      - `available_mined` string, required — The value of all available mined assets. Equals to total mined balance minus frozen mined.
      - `available_pending_incoming` string, required — The value of all available pending incoming assets. Equals to total pending incoming minus frozen pending incoming.
      - `frozen_mined` string, required — The value of all mined frozen assets.
      - `frozen_pending_incoming` string, required — The value of all pending incoming frozen assets.
      - `trustline_limit` string — The trustline limit for Stellar assets. Nil for non-Stellar assets or assets without trustlines.
      - `is_auto_approved` boolean — (Canton) True if incoming transfers of this asset are auto-accepted via a pre-approval.
    - `public_key_compressed` string, required — The compressed public key of the address. As defined in the SEC1 standard: https://www.secg.org/SEC1-Ver-1.0.pdf.
    - `derivation_path` string, required — The BIP-32 derivation path of the address.
    - `type` 'utxo', required — The type of the vault address.
    - `address` UtxoAddress, required
      - `type` 'utxo', required
      - `address` string, required — The UTXO string address.
      - `address_type` 'legacy' | 'p2sh' | 'segwit' | 'taproot' | 'merkleroot', required
      - `chain` UtxoChain, required
        - `chain_type` 'utxo', required — The type of the chain.
        - `unique_id` 'bitcoin_mainnet' | 'bitcoin_testnet' | 'bitcoin_testnet_v4' | 'dogecoin_mainnet' | 'bitcoin_cash_mainnet' | 'pearl_testnet' | 'pearl_mainnet', required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized User
- `403` — Forbidden User
- `408` — Request Timeout
- `422` — Validation Error
- `429` — Rate Limit Exceeded
- `500` — Unexpected Error

---

[API](https://skmtc.net/fordefi/apis/fordefi-api.md) · [All operations](https://skmtc.net/fordefi/apis/fordefi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fordefi/fordefi-api/versions/8014fd69ea17/schema)