Skip to main content
GET
Get Vault spend usage
Reads the shared Vault-wide Zodiac allowance and subtracts in-flight payment reservations. Returns the delegated payment limit, the consumed, pending and currently available amounts, the exact reset time and the supported assets. USDC and USDT consume the same limit. Direct owner-initiated Safe transfers do not consume this delegated allowance.

Authorizations

Authorization
string
header
required

HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.

Headers

Stableyard-Version
enum<string>

Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.

Available options:
2026-09-09

Path Parameters

accountId
string
required

Canonical account id returned by the Accounts API.

Example:

"acct_123"

Response

Vault spend usage

vaultId
string
required
Example:

"vault_123"

status
enum<string>
required
Available options:
active,
not_active
period
string
required
Allowed value: "fixed_30_day"
periodSeconds
integer
required
supportedAssets
object[]
required
reason
string

Present when status is not_active.

limitUsdAtomic
string
Pattern: ^[0-9]+$
limitAtomic
string
Pattern: ^[0-9]+$
consumedAtomic
string
Pattern: ^[0-9]+$
onchainConsumedAtomic
string
Pattern: ^[0-9]+$
settledRecordedAtomic
string
Pattern: ^[0-9]+$
pendingAtomic
string
Pattern: ^[0-9]+$
availableAtomic
string
Pattern: ^[0-9]+$
windowStartedAt
string<date-time>
resetsAt
string<date-time>
observedAt
string<date-time>