---
title: "Validate budget"
method: POST
path: "/api/v2/cost/budget/validate"
tags: ["Cloud Cost Management"]
---

# Validate budget

`POST /api/v2/cost/budget/validate`

Validate a budget configuration without creating or modifying it

## Request body

- BudgetValidationRequest — The request object for validating a budget configuration before creating or updating it.
  - `data` BudgetValidationRequestData — The data object for a budget validation request, containing the resource type, ID, and budget attributes to validate.
    - `attributes` BudgetWithEntriesDataAttributes — The attributes of a budget including all its monthly entries.
      - `created_at` integer — The timestamp when the budget was created.
      - `created_by` string — The ID of the user that created the budget.
      - `end_month` integer — The month when the budget ends, in YYYYMM format.
      - `entries` BudgetWithEntriesDataAttributesEntriesItems[] — The list of monthly budget entries.
        - `amount` number, double — The budgeted amount for this entry.
        - `costs` BudgetWithEntriesDataAttributesEntriesItemsCosts — Cost data for a single budget entry.
          - `actual` number, double, nullable — The actual cost for this entry. Present only when `actual=true` is requested.
          - `amount` number, double, nullable — The budgeted amount for this entry.
          - `custom_forecast` number, double, nullable — The custom forecast override for this entry. `null` when `forecast=true` is requested but no custom forecast has been set for this entry's month. A numeric value, including `0`, indicates an explicit custom forecast override. Omitted when `forecast=false` or the feature is not available for the organization.
          - `forecast` number, double, nullable — The final forecast for this entry, with any custom forecast override applied. Present only when `forecast=true` is requested.
          - `ootb_forecast` number, double, nullable — The out-of-the-box ML forecast for this entry, before custom overrides. Present only when `forecast=true` is requested.
        - `month` integer — The month this budget entry applies to, in YYYYMM format.
        - `tag_filters` BudgetWithEntriesDataAttributesEntriesItemsTagFiltersItems[] — The list of tag filters that scope this budget entry to specific resources.
          - `tag_key` string — The tag key to filter on.
          - `tag_value` string — The tag value to filter on.
      - `metrics_query` string — The cost query used to track spending against the budget.
      - `name` string — The name of the budget.
      - `org_id` integer — The ID of the organization the budget belongs to.
      - `start_month` integer — The month when the budget starts, in YYYYMM format.
      - `total_amount` number, double — The total budget amount across all entries.
      - `updated_at` integer — The timestamp when the budget was last updated.
      - `updated_by` string — The ID of the user that last updated the budget.
    - `id` string — The unique identifier of the budget to validate.
    - `type` 'budget', required — Budget resource type.

## Response `200`

OK

- BudgetValidationResponse — The response object for a budget validation request, containing the validation result data.
  - `data` BudgetValidationResponseData — The data object for a budget validation response, containing the resource type, ID, and validation attributes.
    - `attributes` BudgetValidationResponseDataAttributes — The attributes of a budget validation response, including any validation errors and the validity status.
      - `errors` string[] — A list of validation error messages for the budget.
      - `valid` boolean — Whether the budget configuration is valid.
    - `id` string — The unique identifier of the budget being validated.
    - `type` 'budget_validation', required — Budget validation resource type.

## Other responses

- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)