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

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/model-lab-api/facet-values`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

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