v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Cloud Cost Management

Get budget

Get a budget by ID. Pass actual=true or forecast=true to include cost data in the response. Use start and end (millisecond epochs, both required) to set the cost window. When forecast=true, each entry also includes ootb_forecast (the ML forecast before overrides) and custom_forecast (null if no override is set, a number if one is).

get/api/v2/cost/budget/{budget_id}

Path parameters

budget_idstring required

Budget id.

Query parameters

actualboolean

When true, includes actual cost data in the response.

forecastboolean

When true, includes forecast cost data in the response, including ootb_forecast and custom_forecast per entry.

startinteger

Start of the cost window in milliseconds since epoch. Must be used together with end.

endinteger

End of the cost window in milliseconds since epoch. Must be used together with start.

Response

Example response

{
  "data": {
    "attributes": {
      "created_at": 1738258683590,
      "created_by": "00000000-0a0a-0a0a-aaa0-00000000000a",
      "end_month": 202502,
      "metrics_query": "aws.cost.amortized{service:ec2} by {service}",
      "name": "my budget",
      "org_id": 123,
      "start_month": 202501,
      "total_amount": 1000,
      "updated_at": 1738258683590,
      "updated_by": "00000000-0a0a-0a0a-aaa0-00000000000a"
    },
    "id": "00000000-0a0a-0a0a-aaa0-00000000000a"
  }
}