Skip to main content
POST
Call billing.usage_summary

Authorizations

Authorization
string
header
required

An API key minted at Settings › API & MCP. Send it as Authorization: Bearer <key>. A key carries its holder's own permissions, resolved on every call — revoking a membership closes the key's reach immediately. Keep it in an environment variable (GOOSY_API_KEY), never in a committed file.

Headers

x-request-id
string

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.

Maximum string length: 128

Body

application/json
month
string

Which calendar month to summarize, as YYYY-MM. Leave it out for the current month. Never guess a month they did not name.

Pattern: ^\d{4}-(0[1-9]|1[0-2])$

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.

The tool ran and answered.

ok
boolean
required
month
string
required
spent_credits
number
required
workspace_rollup
object[]
required
recent_entries
object[]
required
more_entries
boolean
required
display_time_zone
string | null
required