Skip to content

Vault custody history

GET
/vaults/{vaultId}/audit

The vault’s tamper-evident custody history — creation, activation, policy and spend-limit changes, and every authorized signing — newest first. Each entry carries a hash that chains it to the previous one, so any gap or edit is detectable.

vaultId
required
string

Audit events, newest first.

object
vault_id
string
events
Array<object>
object
seq
integer
event

E.g. vault.created, vault.active, tx.signed

string
timestamp
string format: date-time
hash

Chain hash linking this entry to the previous

string

Missing, malformed, or invalid request signature.

Failures return a single human-readable error message; the HTTP status carries the category (400 validation, 401 auth, 403 refused, 404 missing, 409 conflict, 429 rate limit). When a signing request is refused for a specific reason, the message names it — for example the amount exceeds a spend limit, the policy denied the recipient, or the intent signature did not verify.

object
error
required
string
code
required

Stable machine slug (invalid_request, unauthorized, forbidden, not_found, conflict, rate_limited); a refused sign names the reason in the message

string
Example
{
"error": "request signature did not verify",
"code": "unauthorized"
}

The resource does not exist (or is not visible to your org).

Failures return a single human-readable error message; the HTTP status carries the category (400 validation, 401 auth, 403 refused, 404 missing, 409 conflict, 429 rate limit). When a signing request is refused for a specific reason, the message names it — for example the amount exceeds a spend limit, the policy denied the recipient, or the intent signature did not verify.

object
error
required
string
code
required

Stable machine slug (invalid_request, unauthorized, forbidden, not_found, conflict, rate_limited); a refused sign names the reason in the message

string
Example
{
"error": "vault not found",
"code": "not_found"
}