---
title: "GET /api/metric/{id}/dimension"
method: GET
path: "/api/metric/{id}/dimension"
tags: ["/api/metric"]
---

# GET /api/metric/{id}/dimension

`GET /api/metric/{id}/dimension`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/metric/{id}/dimension`
- Auth: API key in header `X-API-Key`

List a metric's curated dimensions, and (when `with-addable=true`) the columns still available to
  add, grouped by source table. Both can be filtered with a `query` name substring.

## Path parameters

- `id` integer, required

## Query parameters

- `query` string, nullable
- `with-addable` boolean, nullable: value must be a valid boolean string ('true' or 'false').
- `include-orphaned` boolean, nullable: value must be a valid boolean string ('true' or 'false').

## Response `2XX`

Successful response

- object
  - `addable` object[], required
  - `added` object[], required

## Other responses

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

## Changes

- **2026-11-04** `2e178f5a7934`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/metric/:id/dimension/get.md)

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) - [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metabase/apis/metabase-api/revisions/2e178f5a7934?raw)