Query users
https://api.datadoghq.com/api/v2/product-analytics/users/queryhttps://api.us3.datadoghq.com/api/v2/product-analytics/users/queryhttps://api.us5.datadoghq.com/api/v2/product-analytics/users/queryhttps://api.datadoghq.eu/api/v2/product-analytics/users/queryhttps://api.ap1.datadoghq.com/api/v2/product-analytics/users/queryhttps://api.ap2.datadoghq.com/api/v2/product-analytics/users/queryhttps://api.uk1.datadoghq.com/api/v2/product-analytics/users/queryhttps://api.ddog-gov.com/api/v2/product-analytics/users/queryhttps://api.us2.ddog-gov.com/api/v2/product-analytics/users/queryOverview
Query users with flexible filtering by user properties, with optional wildcard search
Request
Body Data (required)
dataThe data object containing the resource type and attributes for querying users.
attributesAttributes for filtering and shaping the user query results.
limitMaximum number of user records to return in the response.
queryFilter expression using user attribute conditions to narrow results.
select_columnsList of user attribute column names to include in the response.
sortSorting configuration specifying the field and direction for ordering user query results.
fieldThe user attribute field name to sort results by.
orderThe sort direction, either ascending or descending.
wildcard_search_termFree-text term used for wildcard search across user attribute values.
idUnique identifier for the query users request resource.
type [required]Query users request resource type.
query_users_requestquery_users_request{
"data": {
"attributes": {
"limit": 25,
"query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
"select_columns": [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen"
],
"sort": {
"field": "first_seen",
"order": "DESC"
},
"wildcard_search_term": "john"
},
"id": "query_users_request",
"type": "query_users_request"
}
}Response
Successful response with user data
Response containing the query results with matched records and total count.
dataThe data object containing the resource type and attributes of the query response.
attributesAttributes of the query response, containing the matched records and total count.
hitsThe list of matching records returned by the query, each as a map of attribute names to values.
totalTotal number of records matching the query, regardless of the limit applied.
idUnique identifier for the query response resource.
type [required]Query response resource type.
query_responsequery_response{
"data": {
"attributes": {
"hits": [
{
"first_browser_name": "Chrome",
"first_city": "San Francisco",
"first_country_code": "US",
"first_device_type": "Desktop",
"last_seen": "2025-08-14T06:45:12.142Z",
"session_count": 47,
"user_created": "2024-12-15T08:42:33.287Z",
"user_email": "john.smith@techcorp.com",
"user_id": "150847",
"user_name": "John Smith",
"user_org_id": "5001"
},
{
"first_browser_name": "Chrome",
"first_city": "Austin",
"first_country_code": "US",
"first_device_type": "Desktop",
"last_seen": "2025-08-14T05:22:08.951Z",
"session_count": 89,
"user_created": "2024-11-28T14:17:45.634Z",
"user_email": "john.williams@techcorp.com",
"user_id": "150848",
"user_name": "John Williams",
"user_org_id": "5001"
},
{
"first_browser_name": "Chrome",
"first_city": "Seattle",
"first_country_code": "US",
"first_device_type": "Desktop",
"last_seen": "2025-08-14T04:18:34.726Z",
"session_count": 23,
"user_created": "2025-01-03T16:33:21.445Z",
"user_email": "john.jones@techcorp.com",
"user_id": "150849",
"user_name": "John Jones",
"user_org_id": "5001"
}
],
"total": 147
},
"id": "query_response",
"type": "query_response"
}
}Too many requests
API error response.
errors [required]A list of errors.
{
"errors": [
"Bad Request"
]
}Code Example
# 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/users/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"limit": 25,
"query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
"select_columns": [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen"
],
"sort": {
"field": "first_seen",
"order": "DESC"
},
"wildcard_search_term": "john"
},
"id": "query_users_request",
"type": "query_users_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/users/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"limit": 25,
"query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
"select_columns": [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen"
],
"sort": {
"field": "first_seen",
"order": "DESC"
},
"wildcard_search_term": "john"
},
"id": "query_users_request",
"type": "query_users_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/users/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"limit": 25,
"query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
"select_columns": [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen"
],
"sort": {
"field": "first_seen",
"order": "DESC"
},
"wildcard_search_term": "john"
},
"id": "query_users_request",
"type": "query_users_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/users/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"limit": 25,
"query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
"select_columns": [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen"
],
"sort": {
"field": "first_seen",
"order": "DESC"
},
"wildcard_search_term": "john"
},
"id": "query_users_request",
"type": "query_users_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/users/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"limit": 25,
"query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
"select_columns": [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen"
],
"sort": {
"field": "first_seen",
"order": "DESC"
},
"wildcard_search_term": "john"
},
"id": "query_users_request",
"type": "query_users_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/users/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"limit": 25,
"query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
"select_columns": [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen"
],
"sort": {
"field": "first_seen",
"order": "DESC"
},
"wildcard_search_term": "john"
},
"id": "query_users_request",
"type": "query_users_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/users/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"limit": 25,
"query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
"select_columns": [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen"
],
"sort": {
"field": "first_seen",
"order": "DESC"
},
"wildcard_search_term": "john"
},
"id": "query_users_request",
"type": "query_users_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/users/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"limit": 25,
"query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
"select_columns": [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen"
],
"sort": {
"field": "first_seen",
"order": "DESC"
},
"wildcard_search_term": "john"
},
"id": "query_users_request",
"type": "query_users_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/users/query" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"limit": 25,
"query": "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
"select_columns": [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen"
],
"sort": {
"field": "first_seen",
"order": "DESC"
},
"wildcard_search_term": "john"
},
"id": "query_users_request",
"type": "query_users_request"
}
}
EOF// Query users returns "Successful response with user data" response
package main
import (
"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"
)
func main() {
body := datadogV2.QueryUsersRequest{
Data: &datadogV2.QueryUsersRequestData{
Attributes: &datadogV2.QueryUsersRequestDataAttributes{
Limit: datadog.PtrInt64(25),
Query: datadog.PtrString("user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome"),
SelectColumns: []string{
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen",
},
Sort: &datadogV2.QueryUsersRequestDataAttributesSort{
Field: datadog.PtrString("first_seen"),
Order: datadog.PtrString("DESC"),
},
WildcardSearchTerm: datadog.PtrString("john"),
},
Id: datadog.PtrString("query_users_request"),
Type: datadogV2.QUERYUSERSREQUESTDATATYPE_QUERY_USERS_REQUEST,
},
}
ctx := datadog.NewDefaultContext(context.Background())
ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN"))
configuration := datadog.NewConfiguration()
configuration.SetUnstableOperationEnabled("v2.QueryUsers", true)
apiClient := datadog.NewAPIClient(configuration)
api := datadogV2.NewRumAudienceManagementApi(apiClient)
resp, r, err := api.QueryUsers(ctx, body)
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `RumAudienceManagementApi.QueryUsers`: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
responseContent, _ := json.MarshalIndent(resp, "", " ")
fmt.Fprintf(os.Stdout, "Response from `RumAudienceManagementApi.QueryUsers`:\n%s\n", responseContent)
}
Instructions
First install the library and its dependencies and then save the example to main.go and run following commands:
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="us3.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="us5.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="datadoghq.eu" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="ap1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="ap2.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="uk1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"DD_SITE="us2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"// Query users returns "Successful response with user data" response
import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v2.api.RumAudienceManagementApi;
import com.datadog.api.client.v2.model.QueryResponse;
import com.datadog.api.client.v2.model.QueryUsersRequest;
import com.datadog.api.client.v2.model.QueryUsersRequestData;
import com.datadog.api.client.v2.model.QueryUsersRequestDataAttributes;
import com.datadog.api.client.v2.model.QueryUsersRequestDataAttributesSort;
import com.datadog.api.client.v2.model.QueryUsersRequestDataType;
import java.util.Arrays;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = ApiClient.getDefaultApiClient();
defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
defaultClient.setUnstableOperationEnabled("v2.queryUsers", true);
RumAudienceManagementApi apiInstance = new RumAudienceManagementApi(defaultClient);
QueryUsersRequest body =
new QueryUsersRequest()
.data(
new QueryUsersRequestData()
.attributes(
new QueryUsersRequestDataAttributes()
.limit(25L)
.query(
"user_email:*@techcorp.com AND first_country_code:US AND"
+ " first_browser_name:Chrome")
.selectColumns(
Arrays.asList(
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen"))
.sort(
new QueryUsersRequestDataAttributesSort()
.field("first_seen")
.order("DESC"))
.wildcardSearchTerm("john"))
.id("query_users_request")
.type(QueryUsersRequestDataType.QUERY_USERS_REQUEST));
try {
QueryResponse result = apiInstance.queryUsers(body);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling RumAudienceManagementApi#queryUsers");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
Instructions
First install the library and its dependencies and then save the example to Example.java and run following commands:
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="us3.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="us5.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="datadoghq.eu" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="ap1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="ap2.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="uk1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"DD_SITE="us2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java""""
Query users returns "Successful response with user data" response
"""
from os import environ
from datadog_api_client import ApiClient, Configuration
from datadog_api_client.v2.api.rum_audience_management_api import RumAudienceManagementApi
from datadog_api_client.v2.model.query_users_request import QueryUsersRequest
from datadog_api_client.v2.model.query_users_request_data import QueryUsersRequestData
from datadog_api_client.v2.model.query_users_request_data_attributes import QueryUsersRequestDataAttributes
from datadog_api_client.v2.model.query_users_request_data_attributes_sort import QueryUsersRequestDataAttributesSort
from datadog_api_client.v2.model.query_users_request_data_type import QueryUsersRequestDataType
body = QueryUsersRequest(
data=QueryUsersRequestData(
attributes=QueryUsersRequestDataAttributes(
limit=25,
query="user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
select_columns=[
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen",
],
sort=QueryUsersRequestDataAttributesSort(
field="first_seen",
order="DESC",
),
wildcard_search_term="john",
),
id="query_users_request",
type=QueryUsersRequestDataType.QUERY_USERS_REQUEST,
),
)
configuration = Configuration()
configuration.access_token = environ["DD_BEARER_TOKEN"]
configuration.unstable_operations["query_users"] = True
with ApiClient(configuration) as api_client:
api_instance = RumAudienceManagementApi(api_client)
response = api_instance.query_users(body=body)
print(response)
Instructions
First install the library and its dependencies and then save the example to example.py and run following commands:
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="us3.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="us5.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="datadoghq.eu" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="ap1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="ap2.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="uk1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"DD_SITE="us2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"# Query users returns "Successful response with user data" response
require "datadog_api_client"
DatadogAPIClient.configure do |config|
config.access_token = ENV["DD_BEARER_TOKEN"]
config.unstable_operations["v2.query_users".to_sym] = true
end
api_instance = DatadogAPIClient::V2::RumAudienceManagementAPI.new
body = DatadogAPIClient::V2::QueryUsersRequest.new({
data: DatadogAPIClient::V2::QueryUsersRequestData.new({
attributes: DatadogAPIClient::V2::QueryUsersRequestDataAttributes.new({
limit: 25,
query: "user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
select_columns: [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen",
],
sort: DatadogAPIClient::V2::QueryUsersRequestDataAttributesSort.new({
field: "first_seen",
order: "DESC",
}),
wildcard_search_term: "john",
}),
id: "query_users_request",
type: DatadogAPIClient::V2::QueryUsersRequestDataType::QUERY_USERS_REQUEST,
}),
})
p api_instance.query_users(body)
Instructions
First install the library and its dependencies and then save the example to example.rb and run following commands:
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="us3.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="us5.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="datadoghq.eu" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="ap1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="ap2.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="uk1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"DD_SITE="us2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"// Query users returns "Successful response with user data" response
use datadog_api_client::datadog;
use datadog_api_client::datadogV2::api_rum_audience_management::RumAudienceManagementAPI;
use datadog_api_client::datadogV2::model::QueryUsersRequest;
use datadog_api_client::datadogV2::model::QueryUsersRequestData;
use datadog_api_client::datadogV2::model::QueryUsersRequestDataAttributes;
use datadog_api_client::datadogV2::model::QueryUsersRequestDataAttributesSort;
use datadog_api_client::datadogV2::model::QueryUsersRequestDataType;
#[tokio::main]
async fn main() {
let body =
QueryUsersRequest
::new().data(
QueryUsersRequestData::new(QueryUsersRequestDataType::QUERY_USERS_REQUEST)
.attributes(
QueryUsersRequestDataAttributes::new()
.limit(25)
.query(
"user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome".to_string(),
)
.select_columns(
vec![
"user_id".to_string(),
"user_email".to_string(),
"user_name".to_string(),
"user_org_id".to_string(),
"first_country_code".to_string(),
"first_browser_name".to_string(),
"first_device_type".to_string(),
"last_seen".to_string()
],
)
.sort(
QueryUsersRequestDataAttributesSort::new()
.field("first_seen".to_string())
.order("DESC".to_string()),
)
.wildcard_search_term("john".to_string()),
)
.id("query_users_request".to_string()),
);
let mut configuration = datadog::Configuration::new();
configuration.set_unstable_operation_enabled("v2.query_users", true);
let api = RumAudienceManagementAPI::with_config(configuration);
let resp = api.query_users(body).await;
if let Ok(value) = resp {
println!("{:#?}", value);
} else {
println!("{:#?}", resp.unwrap_err());
}
}
Instructions
First install the library and its dependencies and then save the example to src/main.rs and run following commands:
DD_SITE="datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="us3.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="us5.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="datadoghq.eu" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="ap1.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="ap2.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="uk1.datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="ddog-gov.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo runDD_SITE="us2.ddog-gov.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo run/**
* Query users returns "Successful response with user data" response
*/
import { client, v2 } from "@datadog/datadog-api-client";
const configuration = client.createConfiguration({
authMethods: {
AuthZ: {
accessToken: process.env.DD_BEARER_TOKEN as string,
},
},
});
configuration.unstableOperations["v2.queryUsers"] = true;
const apiInstance = new v2.RumAudienceManagementApi(configuration);
const params: v2.RumAudienceManagementApiQueryUsersRequest = {
body: {
data: {
attributes: {
limit: 25,
query:
"user_email:*@techcorp.com AND first_country_code:US AND first_browser_name:Chrome",
selectColumns: [
"user_id",
"user_email",
"user_name",
"user_org_id",
"first_country_code",
"first_browser_name",
"first_device_type",
"last_seen",
],
sort: {
field: "first_seen",
order: "DESC",
},
wildcardSearchTerm: "john",
},
id: "query_users_request",
type: "query_users_request",
},
},
};
apiInstance
.queryUsers(params)
.then((data: v2.QueryResponse) => {
console.log(
"API called successfully. Returned data: " + JSON.stringify(data)
);
})
.catch((error: any) => console.error(error));
Instructions
First install the library and its dependencies and then save the example to example.ts and run following commands:
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="us3.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="us5.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="datadoghq.eu" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="ap1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="ap2.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="uk1.datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"DD_SITE="us2.ddog-gov.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"