---
title: "Operator dashboard: deployment-wide usage, protected by a separate ADMIN_TOKEN secret"
method: GET
path: "/admin/usage"
---

# Operator dashboard: deployment-wide usage, protected by a separate ADMIN_TOKEN secret

`GET /admin/usage`

## Request

- Base URL: `https://api.hlaverify.com`
- URL: `https://api.hlaverify.com/admin/usage`
- Auth: one of:
  - none
  - API key in header `X-API-Key`

Authorization: Bearer <ADMIN_TOKEN>, a secret distinct from every customer API key, never accepted as one. Totals for 24h/7d/30d (calls, unique key labels, anonymous calls), a 30-day daily series, breakdowns by endpoint, tier and status class, the top 20 key labels by calls, p50/p95 latency and the overall error rate, and an unmet-requests report: per request shape the service cannot fully serve, requests, distinct callers (keyed, paid, repeat), endpoints and a ranking score over 30 days — counts of shapes, never the strings. JSON by default; Accept: text/html or ?format=html returns a small self-contained HTML dashboard with inline SVG bar charts, no external assets.

## Query parameters

- `format` 'html'

## Response `200`

usage (JSON or, with Accept: text/html or ?format=html, an HTML dashboard)

## Other responses

- `401`: missing or invalid admin token
- `503`: admin dashboard or usage reporting not configured on this deployment

---

[API](https://skmtc.dev/hlaverify/apis/hla-verify.md) · [All operations](https://skmtc.dev/hlaverify/apis/hla-verify/llms.txt) · [OpenAPI document](https://skmtc.dev/hlaverify/apis/hla-verify/revisions/40cd5e7d134d?raw)