List Cloud Cost Management tag metadata months

GET https://api.ap1.datadoghq.com/api/v2/cost/tag_metadata/monthshttps://api.ap2.datadoghq.com/api/v2/cost/tag_metadata/monthshttps://api.datadoghq.eu/api/v2/cost/tag_metadata/monthshttps://api.ddog-gov.com/api/v2/cost/tag_metadata/monthshttps://api.us2.ddog-gov.com/api/v2/cost/tag_metadata/monthshttps://api.datadoghq.com/api/v2/cost/tag_metadata/monthshttps://api.us3.datadoghq.com/api/v2/cost/tag_metadata/monthshttps://api.us5.datadoghq.com/api/v2/cost/tag_metadata/months

Overview

List months that have Cloud Cost Management tag metadata for a given provider, ordered most-recent first. The response is capped at 36 months. This endpoint requires the cloud_cost_management_read permission.

OAuth apps require the cloud_cost_management_read authorization scope to access this endpoint.

Arguments

Query Strings

Response

• 200
• 400
• 403
• 429

{
  "data": [
    {
      "id": "2026-04",
      "type": "cost_tag_metadata_month"
    },
    {
      "id": "2026-03",
      "type": "cost_tag_metadata_month"
    }
  ]
}

{
  "errors": [
    "Bad Request"
  ]
}

{
  "errors": [
    "Bad Request"
  ]
}

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

                  # Required query arguments
export filter[provider]="aws"
# Curl command
curl -X GET "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/tag_metadata/months?filter[provider]=${filter[provider]}" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"