---
title: "List or look up canonical metrics"
method: GET
path: "/v1/metrics/"
tags: ["metrics"]
---

# List or look up canonical metrics

`GET /v1/metrics/`

## Request

- Base URL: `https://mcp.wisesheets.io`
- URL: `https://mcp.wisesheets.io/v1/metrics/`
- Auth: HTTP bearer

Standardized catalog of the metric keys this API understands. Use it to discover
what metric keys to pass to /v1/financials, populate UI pickers, or generate
typed SDK enums. With no query parameters, returns the full catalog as a list
envelope; with ?metric=<key>, returns a single entry.

Filtering (`statement`, `unitType`, `q`) is in-memory against the
catalog loaded at server boot; an API process restart is required to pick up
new seed rows.

## Query parameters

- `metric` string
- `statement` 'income_statement' | 'balance_sheet' | 'cash_flow'
- `unitType` 'monetary' | 'shares' | 'ratio' | 'per_share' | 'count'
- `q` string

## Response `200`

Default Response

- union
  - object
    - `data` object[], required
      - `metric` string, required
      - `label` string, required
      - `description` string, nullable, required
      - `statements` string[], required
      - `unitType` 'monetary' | 'shares' | 'ratio' | 'per_share' | 'count', required
      - `isCalculated` boolean, required
      - `supportedFrequencies` string[], required
  - object
    - `data` object, required
      - `metric` string, required
      - `label` string, required
      - `description` string, nullable, required
      - `statements` string[], required
      - `unitType` 'monetary' | 'shares' | 'ratio' | 'per_share' | 'count', required
      - `isCalculated` boolean, required
      - `supportedFrequencies` string[], required

---

[API](https://skmtc.dev/wisesheets/apis/sec-edgar-financial-data-api.md) · [All operations](https://skmtc.dev/wisesheets/apis/sec-edgar-financial-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wisesheets/apis/sec-edgar-financial-data-api/revisions/101907077f28?raw)