---
title: "Get metrics for UI"
method: GET
path: "/api/v1/metrics"
tags: ["metrics"]
---

# Get metrics for UI

`GET /api/v1/metrics`

Get aggregated metrics for dashboard display

## Query parameters

- `start` string, required
- `end` string, required
- `metric_names` string[]
- `aggregation` 'avg' | 'sum' | 'max' | 'min'
- `bucket_size` '1m' | '5m' | '1h' | '1d'

## Response `200`

OK

- GetMetricsResponse
  - `metrics` AggregatedMetric[]
    - `aggregation_type` string
    - `bucket_end` string
    - `bucket_size` integer
    - `bucket_start` string
    - `labels` object
    - `name` string
    - `value` number
  - `query` GetMetricsRequest
    - `aggregation` string
    - `bucket_size` string
    - `end` string
    - `labels` object
    - `metric_names` string[]
    - `start` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.dev/marmotdata/apis/marmot-api.md) · [All operations](https://skmtc.dev/marmotdata/apis/marmot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/marmotdata/marmot-api/revisions/0bd802afff21/schema)