GET
/
api
/
v1
/
budgets
/
status
curl https://api.costmcp.com/api/v1/budgets/status \
  -H "Authorization: Bearer $COSTMCP_API_KEY"

{
  "budgets": [
    {
      "id": "a7e5a4c3-54b9-48b6-abed-5d797223b81d",
      "name": "Monthly AI spend",
      "scope_type": "global",
      "amount": 600,
      "spent": 42.5,
      "remaining": 557.5,
      "percent_used": 0.0708,
      "alert": false
    }
  ]
}
Requires permission read_summaries.
​
budgets
array
required
Budget rows for the workspace
Each budget object:
FieldTypeNotes
idstringUUID
namestring
scope_typestringe.g. global
amountnumberLimit USD
spentnumberCurrent UTC month
remainingnumberamount - spent
percent_usednumberspent / amount
alertbooleantrue when percent_used >= 0.8
curl https://api.costmcp.com/api/v1/budgets/status \
  -H "Authorization: Bearer $COSTMCP_API_KEY"

{
  "budgets": [
    {
      "id": "a7e5a4c3-54b9-48b6-abed-5d797223b81d",
      "name": "Monthly AI spend",
      "scope_type": "global",
      "amount": 600,
      "spent": 42.5,
      "remaining": 557.5,
      "percent_used": 0.0708,
      "alert": false
    }
  ]
}