DAdatadog
AI Gateway

Get an AI Gateway budget

Get a spend budget by ID, including its capacity, scope, reset window, warning threshold, and enforcement mode.

get/api/v2/budgets/{id}

Request

Path parameters

idstring uuid required

Budget UUID.

Response

OK

Example response

{
  "data": {
    "attributes": {
      "capacity_microcents": 100000000,
      "created_at": "2026-08-24T12:00:00Z",
      "created_by": "admin@example.com",
      "enabled": true,
      "enforcement": "BLOCK",
      "monitor_id": 12345678,
      "name": "Coding agents",
      "selector": [
        {
          "dim": "user_id",
          "per_value": true,
          "values": [
            "11111111-1111-1111-1111-111111111111"
          ]
        }
      ],
      "tags": {
        "model": "gpt-5.2-codex"
      },
      "updated_at": "2026-08-24T12:00:00Z",
      "warning_threshold": 0.9,
      "window_policy": "MONTHLY"
    },
    "id": "11111111-1111-1111-1111-111111111111",
    "type": "budgets"
  }
}

Changes

Changes to this operation have not been checked yet.