---
title: "Get account facet info"
method: POST
path: "/api/v2/product-analytics/accounts/facet_info"
tags: ["Rum Audience Management"]
---

# Get account facet info

`POST /api/v2/product-analytics/accounts/facet_info`

Get facet information for account attributes including possible values and counts

## Request body

- FacetInfoRequest — Request body for retrieving facet value information for a specified attribute with optional filtering.
  - `data` FacetInfoRequestData — The data object containing the resource type and attributes for the facet info request.
    - `attributes` FacetInfoRequestDataAttributes — Attributes for the facet info request, specifying which facet to query and optional filters to apply.
      - `facet_id` string, required — The identifier of the facet attribute to retrieve value information for.
      - `limit` integer, required — Maximum number of facet values to return in the response.
      - `search` FacetInfoRequestDataAttributesSearch — Query-based search configuration for filtering the audience context when retrieving facet values.
        - `query` string — The filter expression used to scope the audience from which facet values are retrieved.
      - `term_search` FacetInfoRequestDataAttributesTermSearch — Term-level search configuration for filtering facet values by an exact or partial term match.
        - `value` string — The term string to match against facet values.
    - `id` string — Unique identifier for the facet info request resource.
    - `type` 'users_facet_info_request', required — Users facet info request resource type.

## Response `200`

Successful response with facet information

- FacetInfoResponse — Response containing facet information for an attribute, including its distinct values and occurrence counts.
  - `data` FacetInfoResponseData — The data object containing the resource type and attributes for the facet info response.
    - `attributes` FacetInfoResponseDataAttributes — Attributes of the facet info response, containing the facet result data.
      - `result` FacetInfoResponseDataAttributesResult — The facet query result containing discrete value counts or a numeric range for the requested facet.
        - `range` FacetInfoResponseDataAttributesResultRange — The numeric range of a facet attribute, representing the minimum and maximum observed values.
          - `max` object — The maximum observed value for the numeric facet attribute.
          - `min` object — The minimum observed value for the numeric facet attribute.
        - `values` FacetInfoResponseDataAttributesResultValuesItems[] — List of discrete facet values with their occurrence counts.
          - `count` integer — The number of records that have this facet value.
          - `value` string — The facet value (for example, a browser name or country code).
    - `id` string — Unique identifier for the facet info response resource.
    - `type` 'users_facet_info', required — Users facet info resource type.

## Other responses

- `429` — Too many requests

---

[API](https://skmtc.dev/datadog/apis/api-v2.md) · [All operations](https://skmtc.dev/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)