---
title: "List agentless host facets"
method: GET
path: "/api/v2/csm/settings/agentless_hosts/facets"
tags: ["CSM Settings"]
---

# List agentless host facets

`GET /api/v2/csm/settings/agentless_hosts/facets`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/csm/settings/agentless_hosts/facets`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Get the list of available facets for filtering agentless hosts.

## Response `200`

OK

- CsmAgentlessHostFacetsResponse: The response returned when listing facets for agentless hosts.
  - `data` CsmAgentlessHostFacetData[], required: The list of available facets for agentless hosts.
    - `attributes` CsmAgentlessHostFacetAttributes, required: Attributes of an agentless host facet.
      - `bounded` boolean, required: Whether the facet has a bounded set of allowed values. `true` indicates a fixed value set and `false` indicates free-form values.
      - `bundled` boolean, required: Whether the facet is bundled as part of the default facet set. `true` indicates bundled and `false` indicates custom.
      - `bundledAndUsed` boolean, required: Whether the facet is both bundled and actively used. `true` indicates in use; `false` indicates unused.
      - `defaultValues` string[], required: The list of default filter values for the facet.
      - `description` string, required: A human-readable description of what the facet represents.
      - `editable` boolean, required: Whether the facet can be edited by users. `true` indicates editable; `false` indicates read-only.
      - `facetType` string, required: The UI display type for the facet, such as `list`.
      - `groups` string[], required: The list of UI groups that this facet belongs to.
      - `name` string, required: The display name of the facet.
      - `path` string, required: The field path used when filtering by this facet.
      - `source` string, required: The data source that provides the facet values.
      - `type` string, required: The data type of the facet values.
      - `values` string[], required: The list of allowed filter values for bounded facets. Empty for unbounded facets.
    - `id` string, required: The identifier of the facet, corresponding to the field path.
    - `type` 'agentless_host_facet', required: The JSON:API type for agentless host facet resources. The value should always be `agentless_host_facet`.

## Other responses

- `403`: Not Authorized
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)