Skip to main content
GET
Get account vault
Returns the account Vault, its active policy, current 30-day spend usage, pending actions, mandates and audit-facing state. Fund or use the Vault only once status is active.

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

id
string
required
Example:

"vault_123"

accountId
string
required
Example:

"acct_123"

chainId
integer
required
Example:

42161

ownershipMode
enum<string>
required
Available options:
external,
stableyard
status
enum<string>
required
Available options:
pending_authorization,
provisioning,
awaiting_policy,
active,
suspended,
failed,
requires_intervention
monitoring
object
required
earning
object
required
resourceVersion
integer
required
Required range: x >= 1
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
safeAddress
string | null
predictedSafeAddress
string | null

Allocated Safe address, persisted before managed creation returns. The address is not evidence of deployment or readiness to receive funds. Wait for status active before funding or using the Vault.

rolesModuleAddress
string | null
activePolicyId
string | null
activePolicy
Active Vault policy · object | null
latestPolicy
Latest Vault policy · object | null
nextAction
Vault action required · object | null
pendingActions
object[]
spendUsage
object
mandates
object[]
failureCode
string | null