---
title: "How much each metric is used"
method: GET
path: "/api/{org_id}/metrics/usage"
tags: ["Metrics"]
---

# How much each metric is used

`GET /api/{org_id}/metrics/usage`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/metrics/usage`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/metrics/usage/get.ts> (a function with typed inputs; its response is checked against the schema)

Counts, per metric, the dashboards, alerts, SLOs and scheduled pipelines the caller can read whose queries reference it, in one scan of the org

## Path parameters

- `org_id` string, required

## Response `200`

Success

- OrgMetricUsage: Usage counts for each current metric stream that visible objects read; other names are dropped.
  - `metrics` object, required

## Other responses

- `500`: Internal Server Error

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)