SQRL/ Docs
GET/api/v1/list-wallets

List vaults

Lists every vault in a workspace with its approver set, spending limit, and current usage.

AccessRequires a permission in the workspaceVIEW_BALANCES

This is the call behind the Vaults page: one request returns every vault in the workspace, each with its address, approval threshold, signers by name, and spending limit with usage and next reset. Each entry is a Vault, documented under Shared objects.

The ids it returns are what the rest of the API expects wherever a vault_id or wallet_id is required, including GET /api/v1/get-vault for a single vault in full.

note:
Limits can come back incomplete

Spending limits are held by the policy service. When that service cannot be reached for a vault, the vault is still listed, with a limit_error string in place of detailed_vault_limits, and the top-level errors array reports what went wrong. A response carrying errors is not a failed request: read it as a complete list of vaults whose limit data is partial.

Query parameters
workspace_idnumberrequired
The workspace whose vaults to list. You must hold VIEW_BALANCES in it.
Was this page helpful?