---
title: "List Model Lab run facet values"
method: GET
path: "/api/v2/model-lab-api/facet-values"
tags: ["Model Lab API"]
---

# List Model Lab run facet values

`GET /api/v2/model-lab-api/facet-values`

List available facet values for a specific run facet key.

## Query parameters

- `filter[project_id]` integer, required
- `facet_type` 'parameter' | 'attribute' | 'tag' | 'metric', required — The type of facet for filtering Model Lab runs.
- `facet_name` string, required

## Response `200`

OK

- ModelLabFacetValuesResponse — Response containing available values for a facet key.
  - `data` ModelLabFacetValuesData, required — A facet values JSON:API resource object.
    - `attributes` ModelLabFacetValuesAttributes, required — Available values for a specific facet key.
      - `facet_name` string, required — The name of the facet.
      - `facet_type` string, required — The type of the facet.
      - `metric_stat_ranges` ModelLabMetricStatRange[] — The ranges for each metric statistic.
        - `max` number, double, required — The maximum value of the statistic.
        - `min` number, double, required — The minimum value of the statistic.
        - `stat` string, required — The metric statistic name.
      - `numeric_range` ModelLabNumericRange — The numeric range of values for a facet.
        - `max` number, double, required — The maximum value.
        - `min` number, double, required — The minimum value.
      - `values` string[], required — The list of available string values for this facet.
    - `id` string, required — The unique identifier of the facet values resource.
    - `type` 'facet_values', required — The JSON:API type for a facet values resource.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — Too many requests
- `500` — Internal Server Error

---

[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)