Retrieve all tag policies for the organization. Optionally include disabled or deleted
policies, filter by telemetry source, and include each policy’s current compliance score
via the include=score query parameter.
Arguments
Query Strings
Name
Type
Description
include_disabled
boolean
Whether to include policies that are currently disabled. Defaults to false.
include_deleted
boolean
Whether to include policies that have been soft-deleted. Defaults to false.
include
enum
Comma-separated list of related resources to include alongside each policy in the response. Currently the only supported value is score. Allowed enum values: score
filter[source]
enum
Restrict the result set to policies whose source matches the given value. Allowed enum values: logs, spans, metrics, rum, feed
ts_start
integer
Start of the time window used for compliance score computation, as a Unix timestamp in milliseconds. Defaults to a recent window appropriate for the source.
ts_end
integer
End of the time window used for compliance score computation, as a Unix timestamp in milliseconds. Must be in the past and greater than ts_start.
The RFC 3339 timestamp at which the policy was created.
created_by [required]
string
The identifier of the user who created the policy.
deleted_at
date-time
The RFC 3339 timestamp at which the policy was soft-deleted. null if the policy has not been deleted. Only present when include_deleted=true is requested.
deleted_by
string
The identifier of the user who soft-deleted the policy. null if the policy has not been deleted.
enabled [required]
boolean
Whether the policy is currently enforced.
modified_at [required]
date-time
The RFC 3339 timestamp at which the policy was last modified.
modified_by [required]
string
The identifier of the user who last modified the policy.
negated [required]
boolean
When true, the policy matches tag values that do NOT match any of the supplied patterns.
policy_name [required]
string
Human-readable name for the tag policy.
policy_type [required]
enum
How the policy is enforced. blocking rejects telemetry that violates the policy.
surfacing only highlights non-compliant telemetry without blocking it.
Allowed enum values: blocking,surfacing
required [required]
boolean
When true, telemetry without this tag is treated as a violation.
scope [required]
string
The scope the policy applies within.
source [required]
enum
The telemetry source that a tag policy applies to.
Allowed enum values: logs,spans,metrics,rum,feed
tag_key [required]
string
The tag key that the policy governs.
tag_value_patterns [required]
[string]
The patterns that valid values for the tag key must match.
version [required]
int64
A monotonically increasing version counter that is incremented on each update.
id [required]
string
The unique identifier of the tag policy.
relationships
object
Related resources for a tag policy. Only present when the corresponding include query parameter is supplied.
score
object
A relationship to the compliance score resource for this policy.
data [required]
object
Identifier of the related compliance score resource.
id [required]
string
The unique identifier of the related compliance score resource.
type [required]
enum
JSON:API resource type for a tag policy compliance score.
Allowed enum values: tag_policy_score
type [required]
enum
JSON:API resource type for a tag policy.
Allowed enum values: tag_policy
included
[object]
Related resources fetched alongside the primary tag policies. Populated when an include query parameter is supplied.
attributes [required]
object
Attributes of a tag policy compliance score.
score [required]
double
The compliance score for the policy over the requested time window, as a percentage
between 0 and 100. null indicates that no relevant telemetry was found.
ts_end [required]
int64
End of the time window the score was computed over, as a Unix timestamp in milliseconds.
ts_start [required]
int64
Start of the time window the score was computed over, as a Unix timestamp in milliseconds.
version [required]
int64
The version of the tag policy that the score was computed against.
id [required]
string
The unique identifier of the compliance score resource.
type [required]
enum
JSON:API resource type for a tag policy compliance score.
Allowed enum values: tag_policy_score
{"data":[{"attributes":{"created_at":"2026-05-21T22:11:06.108696Z","created_by":"test-user","deleted_at":"2019-09-19T10:00:00.000Z","deleted_by":"string","enabled":true,"modified_at":"2026-05-21T22:11:06.108696Z","modified_by":"test-user","negated":false,"policy_name":"Service tag must be one of api or web","policy_type":"surfacing","required":true,"scope":"env","source":"logs","tag_key":"service","tag_value_patterns":["api","web"],"version":1},"id":"123","relationships":{"score":{"data":{"id":"123-v1-1779315066097-1779401466097","type":"tag_policy_score"}}},"type":"tag_policy"}],"included":[{"attributes":{"score":80,"ts_end":1779401466097,"ts_start":1779315066097,"version":1},"id":"123-v1-1779315066097-1779401466097","type":"tag_policy_score"}]}
"""
List tag policies returns "OK" response
"""fromdatadog_api_clientimportApiClient,Configurationfromdatadog_api_client.v2.api.tag_policies_apiimportTagPoliciesApiconfiguration=Configuration()configuration.unstable_operations["list_tag_policies"]=TruewithApiClient(configuration)asapi_client:api_instance=TagPoliciesApi(api_client)response=api_instance.list_tag_policies()print(response)
# List tag policies returns "OK" responserequire"datadog_api_client"DatadogAPIClient.configuredo|config|config.unstable_operations["v2.list_tag_policies".to_sym]=trueendapi_instance=DatadogAPIClient::V2::TagPoliciesAPI.newpapi_instance.list_tag_policies()
// List tag policies 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())configuration:=datadog.NewConfiguration()configuration.SetUnstableOperationEnabled("v2.ListTagPolicies",true)apiClient:=datadog.NewAPIClient(configuration)api:=datadogV2.NewTagPoliciesApi(apiClient)resp,r,err:=api.ListTagPolicies(ctx,*datadogV2.NewListTagPoliciesOptionalParameters())iferr!=nil{fmt.Fprintf(os.Stderr,"Error when calling `TagPoliciesApi.ListTagPolicies`: %v\n",err)fmt.Fprintf(os.Stderr,"Full HTTP response: %v\n",r)}responseContent,_:=json.MarshalIndent(resp,""," ")fmt.Fprintf(os.Stdout,"Response from `TagPoliciesApi.ListTagPolicies`:\n%s\n",responseContent)}
// List tag policies returns "OK" responseimportcom.datadog.api.client.ApiClient;importcom.datadog.api.client.ApiException;importcom.datadog.api.client.v2.api.TagPoliciesApi;importcom.datadog.api.client.v2.model.TagPoliciesListResponse;publicclassExample{publicstaticvoidmain(String[]args){ApiClientdefaultClient=ApiClient.getDefaultApiClient();defaultClient.setUnstableOperationEnabled("v2.listTagPolicies",true);TagPoliciesApiapiInstance=newTagPoliciesApi(defaultClient);try{TagPoliciesListResponseresult=apiInstance.listTagPolicies();System.out.println(result);}catch(ApiExceptione){System.err.println("Exception when calling TagPoliciesApi#listTagPolicies");System.err.println("Status code: "+e.getCode());System.err.println("Reason: "+e.getResponseBody());System.err.println("Response headers: "+e.getResponseHeaders());e.printStackTrace();}}}
// List tag policies returns "OK" response
usedatadog_api_client::datadog;usedatadog_api_client::datadogV2::api_tag_policies::ListTagPoliciesOptionalParams;usedatadog_api_client::datadogV2::api_tag_policies::TagPoliciesAPI;#[tokio::main]asyncfnmain(){letmutconfiguration=datadog::Configuration::new();configuration.set_unstable_operation_enabled("v2.ListTagPolicies",true);letapi=TagPoliciesAPI::with_config(configuration);letresp=api.list_tag_policies(ListTagPoliciesOptionalParams::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="<API-KEY>"DD_APP_KEY="<APP-KEY>"cargo run
/**
* List tag policies returns "OK" response
*/import{client,v2}from"@datadog/datadog-api-client";constconfiguration=client.createConfiguration();configuration.unstableOperations["v2.listTagPolicies"]=true;constapiInstance=newv2.TagPoliciesApi(configuration);apiInstance.listTagPolicies().then((data: v2.TagPoliciesListResponse)=>{console.log("API called successfully. Returned data: "+JSON.stringify(data));}).catch((error: any)=>console.error(error));