---
title: "POST /api/metric/breakout-values"
method: POST
path: "/api/metric/breakout-values"
tags: ["/api/metric"]
---

# POST /api/metric/breakout-values

`POST /api/metric/breakout-values`

Fetch distinct breakout dimension values for a metric or measure definition.
   Accepts the same definition format as POST /dataset.
   Returns extracted values and column metadata for the breakout dimension.

## Request body

- MetabaseMetricsApiDatasetRequest — Schema for POST /dataset request body.
  - `definition` MetabaseMetricsApiDefinition, required — Schema for the definition object within a dataset request. Uses expression-based contract for metric math support.
    - `expression` union, required — A recursive metric math expression tree. Can be a leaf (metric/measure ref) or an arithmetic expression [op opts expr expr ...] with at least 2 operands. Note: uses :fn validator for arithmetic to avoid Malli's recursive seqex limitation.
      - union — A leaf node in a metric math expression: either a metric or measure reference.
        - unknown[] — A metric reference in an expression: [:metric {:lib/uuid uuid} card-id].
          - unknown
        - unknown[] — A measure reference in an expression: [:measure {:lib/uuid uuid} measure-id].
          - unknown
      - number
    - `filters` MetabaseLibMetricSchemaInstanceFilter[] — A sequence of per-instance filters.
      - `filter` unknown, required
      - `lib/uuid` string, required
    - `projections` MetabaseLibMetricSchemaTypedProjection[] — A sequence of typed projections.
      - `id` integer, required
      - `lib/uuid` string, required
      - `projection` MetabaseLibMetricSchemaDimensionReference[], required
        - unknown[] — Dimension reference clause [:dimension opts uuid]. Handles normalization from JSON where the tag arrives as a string.
          - unknown
      - `type` 'metric' | 'measure', required

## Response `2XX`

Successful response

- MetabaseMetricsApiBreakoutValuesResponse
  - `col` object, required
  - `values` unknown[], required
    - unknown

## Other responses

- `4XX` — Client error response
- `5XX` — Server error response

---

[API](https://skmtc.net/metabase/apis/metabase-api.md) · [All operations](https://skmtc.net/metabase/apis/metabase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/metabase/metabase-api/versions/08b5a2bafb4f/schema)