DAdatadog
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}

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v2/cost/budget/{budget_id}
  • Auth
    API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY

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

OK

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"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.