GetHistoricalCostByOrg
Retrieve historical cost data for multi-org or single root-org accounts in Datadog MCP. Specify time range and view to analyze costs at parent-org or sub-org levels. Includes options for connected accounts.
Instructions
Get historical cost across multi-org and single root-org accounts. Cost data for a given month becomes available no later than the 16th of the following month.
This endpoint is only accessible for parent-level organizations.
Query Parameters:
view: String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are
summary
andsub-org
. Defaults tosummary
.start_month (Required): Datetime in ISO-8601 format, UTC, precise to month:
[YYYY-MM]
for cost beginning this month.end_month: Datetime in ISO-8601 format, UTC, precise to month:
[YYYY-MM]
for cost ending this month.include_connected_accounts: Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to
false
.
Responses:
200 (Success): OK
Content-Type:
application/json;datetime-format=rfc3339
Response Properties:
data: Response containing Chargeback Summary.
Example:
400: Bad Request
Content-Type:
application/json;datetime-format=rfc3339
Response Properties:
errors: A list of errors.
Example:
403: Forbidden - User is not authorized
Content-Type:
application/json;datetime-format=rfc3339
Response Properties:
errors: A list of errors.
Example:
429: Too many requests
Content-Type:
application/json;datetime-format=rfc3339
Response Properties:
errors: A list of errors.
Example:
Input Schema
Name | Required | Description | Default |
---|---|---|---|
end_month | No | Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month. | |
include_connected_accounts | No | Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to `false`. | |
start_month | Yes | Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month. | |
view | No | String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are `summary` and `sub-org`. Defaults to `summary`. |