v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Cloud Cost Management

Get a Cloud Cost Management tag description

Get the Cloud Cost Management description for a single tag key. Use filter[cloud] to scope the lookup to a specific cloud provider; when omitted, the response resolves the description in fallback order (cloud-specific organization override, then cloudless organization default, then Datadog's global default).

get/api/v2/cost/tag_descriptions/{tag_key}

Path parameters

tag_keystring required

The tag key whose description is being fetched.

Query parameters

filter[cloud]string

Cloud provider to scope the lookup to (for example, aws). Omit to use the resolved fallback.

Response

Example response

{
  "data": {
    "attributes": {
      "cloud": "aws",
      "created_at": "2026-01-01T12:00:00Z",
      "description": "AWS account that owns this cost.",
      "source": "human",
      "tag_key": "account_id",
      "updated_at": "2026-01-01T12:00:00Z"
    },
    "id": "account_id",
    "type": "cost_tag_description"
  }
}