---
title: "How much is recorded, and by whom, as counts"
method: GET
path: "/api/v1/usage"
tags: ["Service"]
---

# How much is recorded, and by whom, as counts

`GET /api/v1/usage`

## Request

- Base URL: `https://api.riskrouter.eu`
- URL: `https://api.riskrouter.eu/api/v1/usage`
- Auth: none declared

Entries in the quote ledger and the evidence log: totals, the last 7 and 28 days, twelve ISO weeks, and `outside`, the entries recorded with keys that are not RiskRouter's own (self-serve sandbox keys counted separately). Public: nothing but numbers and week dates is returned. Cached for five minutes at the edge. Answers 413 when the logs exceed the single-request counting ceiling, and 502/503 rather than a guess when the ledger cannot be read.

## Response `200`

Counts.

- object
  - `ok` boolean, required
  - `format` 'riskrouter-usage|1', required
  - `as_of` string, date-time, required
  - `quotes` object, required
  - `evidence` object, required
  - `outside` object, required
  - `distributors` object, required
  - `by_week` object[], required
    - `week_start` string, date
    - `quotes` integer
    - `evidence` integer
    - `outside` integer
  - `method` string

## Other responses

- `413`: The logs are past the counting ceiling.
- `502`: The ledger could not be read.
- `503`: The ledger is not bound.

---

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