For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/rum-audience-management/query-accounts.md. A documentation index is available at /llms.txt.
Language
Datadog site

Query accounts

WARNINGNote: This endpoint may be subject to changes.
POSThttps://api.datadoghq.com/api/v2/product-analytics/accounts/queryhttps://api.us3.datadoghq.com/api/v2/product-analytics/accounts/queryhttps://api.us5.datadoghq.com/api/v2/product-analytics/accounts/queryhttps://api.datadoghq.eu/api/v2/product-analytics/accounts/queryhttps://api.ap1.datadoghq.com/api/v2/product-analytics/accounts/queryhttps://api.ap2.datadoghq.com/api/v2/product-analytics/accounts/queryhttps://api.uk1.datadoghq.com/api/v2/product-analytics/accounts/queryhttps://api.ddog-gov.com/api/v2/product-analytics/accounts/queryhttps://api.us2.ddog-gov.com/api/v2/product-analytics/accounts/query

Overview

Query accounts with flexible filtering by account properties

Request

Body Data (required)

Field
Type
Description
data
object

The data object containing the resource type and attributes for querying accounts.

Response

Successful response with account data

Response containing the query results with matched records and total count.

Field
Type
Description
data
object

The data object containing the resource type and attributes of the query response.

Code Example

Query accounts
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/accounts/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 20,
      "query": "plan_type:enterprise AND user_count:>100 AND subscription_status:active",
      "select_columns": [
        "account_id",
        "account_name",
        "user_count",
        "plan_type",
        "subscription_status",
        "created_at",
        "mrr",
        "industry"
      ],
      "sort": {
        "field": "user_count",
        "order": "DESC"
      },
      "wildcard_search_term": "tech"
    },
    "id": "query_account_request",
    "type": "query_account_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/accounts/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 20,
      "query": "plan_type:enterprise AND user_count:>100 AND subscription_status:active",
      "select_columns": [
        "account_id",
        "account_name",
        "user_count",
        "plan_type",
        "subscription_status",
        "created_at",
        "mrr",
        "industry"
      ],
      "sort": {
        "field": "user_count",
        "order": "DESC"
      },
      "wildcard_search_term": "tech"
    },
    "id": "query_account_request",
    "type": "query_account_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/accounts/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 20,
      "query": "plan_type:enterprise AND user_count:>100 AND subscription_status:active",
      "select_columns": [
        "account_id",
        "account_name",
        "user_count",
        "plan_type",
        "subscription_status",
        "created_at",
        "mrr",
        "industry"
      ],
      "sort": {
        "field": "user_count",
        "order": "DESC"
      },
      "wildcard_search_term": "tech"
    },
    "id": "query_account_request",
    "type": "query_account_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/accounts/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 20,
      "query": "plan_type:enterprise AND user_count:>100 AND subscription_status:active",
      "select_columns": [
        "account_id",
        "account_name",
        "user_count",
        "plan_type",
        "subscription_status",
        "created_at",
        "mrr",
        "industry"
      ],
      "sort": {
        "field": "user_count",
        "order": "DESC"
      },
      "wildcard_search_term": "tech"
    },
    "id": "query_account_request",
    "type": "query_account_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/accounts/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 20,
      "query": "plan_type:enterprise AND user_count:>100 AND subscription_status:active",
      "select_columns": [
        "account_id",
        "account_name",
        "user_count",
        "plan_type",
        "subscription_status",
        "created_at",
        "mrr",
        "industry"
      ],
      "sort": {
        "field": "user_count",
        "order": "DESC"
      },
      "wildcard_search_term": "tech"
    },
    "id": "query_account_request",
    "type": "query_account_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/accounts/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 20,
      "query": "plan_type:enterprise AND user_count:>100 AND subscription_status:active",
      "select_columns": [
        "account_id",
        "account_name",
        "user_count",
        "plan_type",
        "subscription_status",
        "created_at",
        "mrr",
        "industry"
      ],
      "sort": {
        "field": "user_count",
        "order": "DESC"
      },
      "wildcard_search_term": "tech"
    },
    "id": "query_account_request",
    "type": "query_account_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/accounts/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 20,
      "query": "plan_type:enterprise AND user_count:>100 AND subscription_status:active",
      "select_columns": [
        "account_id",
        "account_name",
        "user_count",
        "plan_type",
        "subscription_status",
        "created_at",
        "mrr",
        "industry"
      ],
      "sort": {
        "field": "user_count",
        "order": "DESC"
      },
      "wildcard_search_term": "tech"
    },
    "id": "query_account_request",
    "type": "query_account_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/accounts/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 20,
      "query": "plan_type:enterprise AND user_count:>100 AND subscription_status:active",
      "select_columns": [
        "account_id",
        "account_name",
        "user_count",
        "plan_type",
        "subscription_status",
        "created_at",
        "mrr",
        "industry"
      ],
      "sort": {
        "field": "user_count",
        "order": "DESC"
      },
      "wildcard_search_term": "tech"
    },
    "id": "query_account_request",
    "type": "query_account_request"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/product-analytics/accounts/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "limit": 20,
      "query": "plan_type:enterprise AND user_count:>100 AND subscription_status:active",
      "select_columns": [
        "account_id",
        "account_name",
        "user_count",
        "plan_type",
        "subscription_status",
        "created_at",
        "mrr",
        "industry"
      ],
      "sort": {
        "field": "user_count",
        "order": "DESC"
      },
      "wildcard_search_term": "tech"
    },
    "id": "query_account_request",
    "type": "query_account_request"
  }
}
EOF