# List Vaults

Get a list of all vaults in an organization.

Endpoint: GET /api/v1/vaults
Version: 0.2.0
Security: bearerAuth

## Query parameters:

  - `sort_by` (array)
    Enum: "created_at_asc", "created_at_desc", "name_asc", "name_desc", "vault_type_asc", "vault_type_desc", "is_favorite_asc", "is_favorite_desc"

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

  - `vault_ids` (array)
    Vault IDs to filter on.

  - `names` (array)
    List of full names to filter on.

  - `vault_types` (array)
    Vault types to filter on.
    Enum: "aptos", "black_box", "cosmos", "evm", "safe", "solana", "stacks", "starknet", "sui", "ton", "tron", "utxo", "exchange"

  - `vault_states` (array)
    Vault states to filter on.
    Enum: "active", "archived", "deleted", "pending", "aborted"

  - `key_holder_ids` (array)
    List of key holder IDs to filter on.

  - `vault_group_ids` (array)
    List of vault group IDs to filter on. Filter applies to current and pending vault groups.

  - `exclude_vault_group_ids` (array)
    List of vault group IDs to exclude.

  - `origin_type` (string)
    Origin type to filter on.
    Enum: "native", "imported"

  - `account_addresses` (array)
    List of account addresses to filter on.

  - `positive_native_balance_chain_ids` (array)
    List of chain IDs to fetch native assets for. Only vaults with positive native balance in any of these chains will be included in native_assets response.

## Response 200 fields (application/json):

  - `total` (integer, required)

  - `page` (integer, required)

  - `size` (integer, required)

  - `vaults` (array, required)

## Response 400 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

  - `system_error_code` (string)
    An additional system error code in Fordefi.

## Response 401 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 403 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 408 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 422 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (array, required)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 500 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.