GetCostByOrg
Retrieve monthly cost data across multi-organization accounts in Datadog. Use start_month and optional end_month parameters to query historical costs, available by the 16th of the following month. Accessible for parent-level organizations.
Instructions
Get cost across multi-org account.
Cost by org data for a given month becomes available no later than the 16th of the following month.
Note: This endpoint has been deprecated. Please use the new endpoint
/historical_cost
instead.
This endpoint is only accessible for parent-level organizations.
Query Parameters:
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.
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. | |
| start_month | Yes | Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Response containing Chargeback Summary. |