billing

Call billing.budget_status

Read the account's own monthly budget and how much of it is spent, and every other spend cap's burn — 'how much of our budget have we used?', 'what's our monthly budget?', 'do we pause at the budget?', 'how close are we to our spend cap?'. payer_budget is the budget the account set for itself, in credits: this month's spend against it, whether reaching it emails the owners and admins (notify) or pauses work that needs credits (pause), and the percentages they are emailed at. Say the figures back exactly as given. If payer_budget.unavailable is true, say the budget could not be read; never report that as 'no budget', and never report an unavailable cap list as 'no limits'. The other caps are read-only here. Not for changing the budget — that is billing.budget_set; not for the credit balance — that is billing.plan_status.

post/api/v1/tools/billing.budget_status

Request

  • Base URL: https://app.goosybear.ai
  • URL: https://app.goosybear.ai/api/v1/tools/billing.budget_status
  • Auth: HTTP bearer

Headers

x-request-idstring

Your own id for this request, echoed back and recorded on the audit trail. 1–128 characters from A–Z a–z 0–9 . _ : -, starting with a letter or digit; anything else is replaced by a generated id.

Request body

object required

Response

The call was admitted and dispatched. ok says whether the tool succeeded — a refusal the tool itself produced is still a 200, exactly as it is a successful JSON-RPC result over MCP.

OR

Changes

No recorded changes to this operation across all 6 revisions of this API.