---
title: "List Metric Dashboards"
method: GET
path: "/v1/metrics/dashboards"
tags: ["metrics", "public"]
---

# List Metric Dashboards

`GET /v1/metrics/dashboards`

List user-defined metric dashboards.

**Scopes**: `metrics:read`

## Query parameters

- `organization_id` union — Filter by organization ID.
  - string, uuid4 — The organization ID.
  - string[]

## Response `200`

Successful Response

- MetricDashboardSchema[]
  - `created_at` string, date-time, required — Creation timestamp of the object.
  - `modified_at` string, date-time, nullable, required — Last modification timestamp of the object.
  - `id` string, uuid4, required — The ID of the object.
  - `name` string, required — Display name for the dashboard.
  - `metrics` string[], required — List of metric slugs displayed in this dashboard.
  - `organization_id` string, uuid4, required — The ID of the organization owning this dashboard.

## Other responses

- `422` — Validation Error

---

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