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
summaryandsub-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=rfc3339Response Properties:
data: Response containing Chargeback Summary.
Example:
{
"data": [
"unknown_type"
]
}400: Bad Request
Content-Type:
application/json;datetime-format=rfc3339Response Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}403: Forbidden - User is not authorized
Content-Type:
application/json;datetime-format=rfc3339Response Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}429: Too many requests
Content-Type:
application/json;datetime-format=rfc3339Response Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}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`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Response containing Chargeback Summary. |