---
title: "30-day usage series"
method: GET
path: "/api/v1/usage"
tags: ["Account"]
---

# 30-day usage series

`GET /api/v1/usage`

## Request

- Base URL: `https://quizbase.runriva.com`
- URL: `https://quizbase.runriva.com/api/v1/usage`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Daily request counts + summary across all your keys.

## Query parameters

- `days` integer: Trailing days, 1-90.

## Response `200`

Usage payload.

- UsageResponse
  - `summary` UsageSummary, required
    - `tier` 'free' | 'indie' | 'pro' | 'enterprise', required
    - `today` UsageWindow, required
      - `count` integer, required
      - `prev` integer, required
      - `delta` number, nullable, required: Percentage change vs previous equivalent window.
      - `limit` integer, nullable, required
      - `windowStart` string, required
      - `windowEnd` string, required
    - `week` UsageWindow, required
      - `count` integer, required
      - `prev` integer, required
      - `delta` number, nullable, required: Percentage change vs previous equivalent window.
      - `limit` integer, nullable, required
      - `windowStart` string, required
      - `windowEnd` string, required
    - `month` UsageWindow, required
      - `count` integer, required
      - `prev` integer, required
      - `delta` number, nullable, required: Percentage change vs previous equivalent window.
      - `limit` integer, nullable, required
      - `windowStart` string, required
      - `windowEnd` string, required
  - `series` UsageDayPoint[], required
    - `day` string, required
    - `requests` integer, required
    - `errors` integer, required: 5xx count (server-side).
    - `clientErrors` integer, required: 4xx count (caller-side: 401/429/400/422).
  - `meta` MetaUsage, required
    - `from` string, required
    - `to` string, required
    - `days` integer, required
    - `requestId` string, uuid, required: Unique request identifier (also in `X-Request-Id` response header).

## Other responses

- `401`: Missing, malformed, invalid, or revoked API key.
- `403`: IP not allowed (per-key allowlist).
- `429`: Rate limit exceeded. See `Retry-After` header.
- `500`: Server error.

---

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