---
title: "Usage grouped by key, hour or endpoint — errors and p50/p95 latency"
method: GET
path: "/v1/me/usage/breakdown"
---

# Usage grouped by key, hour or endpoint — errors and p50/p95 latency

`GET /v1/me/usage/breakdown`

## Request

- Base URL: `https://api.grundfast.dk`
- URL: `https://api.grundfast.dk/v1/me/usage/breakdown`
- Auth: one of:
  - API key in cookie `gf_session`
  - HTTP bearer

From the hourly rollup (every outcome, not only billed calls). `errorRate` is (clientErrors + rateLimited + serverErrors) / observed, null when nothing was observed. Latency percentiles are read off a fixed histogram (edges 25, 50, 100, 200, 400, 800, 1600 ms). Reachable with the dashboard session or an API key that names the `usage` scope.

## Query parameters

- `gruppering` 'noegle' | 'time' | 'endpoint'
- `range` 'today' | '24h' | '7d' | '30d' | 'month' | '12m'

## Response `200`

OK

- UsageBreakdown
  - `range` 'today' | '24h' | '7d' | '30d' | 'month' | '12m', required
  - `gruppering` 'noegle' | 'time' | 'endpoint', required
  - `from` string, required
  - `to` string, required
  - `rows` object[], required
    - `group` union, required: API key id (0 = the dashboard session), UTC hour (ISO) or endpoint template.
      - string
      - number
    - `key` object, nullable: gruppering=noegle only: the key, when it still exists.
      - `name` string, required
      - `prefix` string, required
    - `calls` number, required
    - `observed` number, required
    - `ok` number, required
    - `clientErrors` number, required
    - `rateLimited` number, required
    - `serverErrors` number, required
    - `expectedFaults` number, required
    - `errorRate` number, nullable, required
    - `latencyAvgMs` number, nullable, required
    - `latencyP50Ms` number, nullable, required
    - `latencyP95Ms` number, nullable, required
    - `latencyMaxMs` number, nullable, required

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error

---

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