---
title: "Usage counters for a key."
method: GET
path: "/admin/keys/{id}/usage"
tags: ["admin"]
---

# Usage counters for a key.

`GET /admin/keys/{id}/usage`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/admin/keys/{id}/usage`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Per-day, per-endpoint usage counters

- KeyUsageResponse: Response for `GET /admin/keys/{id}/usage`.
  - `entries` UsageRow[], required: Per-day, per-endpoint counters (flushed; the buffered writer lags by at most the flush interval).
    - `count` integer, required: Number of authenticated requests recorded.
    - `day` string, required: ISO `YYYY-MM-DD` UTC day.
    - `endpoint` string, required: Endpoint label, e.g. `/route` or `/route/v1`.
  - `key_id` string, required: Key id.
  - `total` integer, required: Sum of all recorded requests for this key.

## Other responses

- `401`: Missing or wrong admin token
- `404`: Unknown key id

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)