Get the Cloud Cost Management billing currency

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

Overview

Get the dominant billing currency observed in Cloud Cost Management data for the requested period. The response wraps the currency in a JSON:API data array containing at most one entry; the array is empty when no currency data is available. 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": "USD",
      "type": "cost_currency"
    }
  ]
}

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

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

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

Code Example

                  # Required query arguments
export filter[month]="2026-02"
# 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/currency?filter[month]=${filter[month]}" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"