Usage Metering

Get cost across multi-org account

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.

get/api/v2/usage/cost_by_org

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v2/usage/cost_by_org
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code: /oauth2/v1/authorize
      Token URL: /oauth2/v1/token scopes: usage_read, billing_read

Query parameters

start_monthstring date-time required

Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for cost beginning this month.

end_monthstring date-time

Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for cost ending this month.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "charges": [
          {
            "charge_type": "on_demand",
            "product_name": "infra_host"
          }
        ]
      },
      "type": "cost_by_org"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.