---
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`

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.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)