Core Spend
Budget Status
Budget and mandate snapshot for a wallet
GET
Budget Status
Returns the current budget status for a wallet, including spending limits, current usage, and mandate details.
Authentication
Any credential with access to the target wallet can call this route:- wallet-bound tenant key
- org-wide tenant key
- authorized platform session
- static operator key
wallet_idquery wins when present- wallet-bound tenant keys auto-fill their bound wallet when
wallet_idis omitted - org-wide tenant keys must send
wallet_id - static operator and some local/demo paths fall back to
AGENT_WALLET_ID
Request
Query Parameters
Example
Response
Errors
400 VALIDATION_ERROR:wallet_idis required for an org-wide tenant key403 REJECTED_POLICY: caller cannot access that wallet404 NOT_FOUND: wallet does not existREJECTED_POLICY: mandate is missing for the target wallet