List Cloud Cost Management tag key descriptions for the organization. Use filter[cloud] to scope the result to a single cloud provider; when omitted, both cross-cloud defaults and cloud-specific descriptions are returned.
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
Name
Type
Description
filter[cloud]
string
Filter descriptions to a specific cloud provider (for example, aws). Omit to return descriptions across all clouds.
List of Cloud Cost Management tag key descriptions for the organization, optionally filtered to a single cloud provider.
Expand All
Field
Type
Description
data [required]
[object]
List of tag key descriptions.
attributes [required]
object
Human-readable description and metadata attached to a Cloud Cost Management tag key, optionally scoped to a single cloud provider.
cloud [required]
string
Cloud provider this description applies to (for example, aws). Empty when the description is the cross-cloud default for the tag key.
created_at [required]
string
Timestamp when the description was created, in RFC 3339 format.
description [required]
string
The human-readable description for the tag key.
source [required]
enum
Origin of the description. human indicates the description was written by a user, ai_generated was produced by AI, and datadog is a default supplied by Datadog.
Allowed enum values: human,ai_generated,datadog
tag_key [required]
string
The tag key this description applies to.
updated_at [required]
string
Timestamp when the description was last updated, in RFC 3339 format.
id [required]
string
Stable identifier of the tag description. Equals the tag key when the description is the cross-cloud default; encodes both the cloud and the tag key when the description is cloud-specific.
type [required]
enum
Type of the Cloud Cost Management tag description resource.
Allowed enum values: cost_tag_description
default: cost_tag_description
{"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"}]}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"python3"example.py"
# List Cloud Cost Management tag descriptions returns "OK" responserequire"datadog_api_client"DatadogAPIClient.configuredo|config|config.access_token=ENV["DD_BEARER_TOKEN"]endapi_instance=DatadogAPIClient::V2::CloudCostManagementAPI.newpapi_instance.list_cost_tag_descriptions()
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"rb"example.rb"
// List Cloud Cost Management tag descriptions returns "OK" responseimportcom.datadog.api.client.ApiClient;importcom.datadog.api.client.ApiException;importcom.datadog.api.client.v2.api.CloudCostManagementApi;importcom.datadog.api.client.v2.model.CostTagDescriptionsResponse;publicclassExample{publicstaticvoidmain(String[]args){ApiClientdefaultClient=ApiClient.getDefaultApiClient();defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));CloudCostManagementApiapiInstance=newCloudCostManagementApi(defaultClient);try{CostTagDescriptionsResponseresult=apiInstance.listCostTagDescriptions();System.out.println(result);}catch(ApiExceptione){System.err.println("Exception when calling CloudCostManagementApi#listCostTagDescriptions");System.err.println("Status code: "+e.getCode());System.err.println("Reason: "+e.getResponseBody());System.err.println("Response headers: "+e.getResponseHeaders());e.printStackTrace();}}}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"java"Example.java"
// List Cloud Cost Management tag descriptions returns "OK" response
usedatadog_api_client::datadog;usedatadog_api_client::datadogV2::api_cloud_cost_management::CloudCostManagementAPI;usedatadog_api_client::datadogV2::api_cloud_cost_management::ListCostTagDescriptionsOptionalParams;#[tokio::main]asyncfnmain(){letconfiguration=datadog::Configuration::new();letapi=CloudCostManagementAPI::with_config(configuration);letresp=api.list_cost_tag_descriptions(ListCostTagDescriptionsOptionalParams::default()).await;ifletOk(value)=resp{println!("{:#?}",value);}else{println!("{:#?}",resp.unwrap_err());}}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_API_KEY="<DD_API_KEY>"DD_APP_KEY="<DD_APP_KEY>"cargo run
/**
* List Cloud Cost Management tag descriptions returns "OK" response
*/import{client,v2}from"@datadog/datadog-api-client";constconfiguration=client.createConfiguration({authMethods:{AuthZ:{accessToken: process.env.DD_BEARER_TOKENasstring,},},});constapiInstance=newv2.CloudCostManagementApi(configuration);apiInstance.listCostTagDescriptions().then((data: v2.CostTagDescriptionsResponse)=>{console.log("API called successfully. Returned data: "+JSON.stringify(data));}).catch((error: any)=>console.error(error));
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"tsc"example.ts"
// List Cloud Cost Management tag descriptions returns "OK" responsepackagemainimport("context""encoding/json""fmt""os""github.com/DataDog/datadog-api-client-go/v2/api/datadog""github.com/DataDog/datadog-api-client-go/v2/api/datadogV2")funcmain(){ctx:=datadog.NewDefaultContext(context.Background())ctx=context.WithValue(ctx,datadog.ContextAccessToken,os.Getenv("DD_BEARER_TOKEN"))configuration:=datadog.NewConfiguration()apiClient:=datadog.NewAPIClient(configuration)api:=datadogV2.NewCloudCostManagementApi(apiClient)resp,r,err:=api.ListCostTagDescriptions(ctx,*datadogV2.NewListCostTagDescriptionsOptionalParameters())iferr!=nil{fmt.Fprintf(os.Stderr,"Error when calling `CloudCostManagementApi.ListCostTagDescriptions`: %v\n",err)fmt.Fprintf(os.Stderr,"Full HTTP response: %v\n",r)}responseContent,_:=json.MarshalIndent(resp,""," ")fmt.Fprintf(os.Stdout,"Response from `CloudCostManagementApi.ListCostTagDescriptions`:\n%s\n",responseContent)}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"go run"main.go"
Request a personalized demo
Get Started with Datadog
Ask AI
AI-generated responses may be inaccurate. Verify important info.