---
title: "Inspect current API usage without spending primary request quota"
method: GET
path: "/api/v1/usage"
tags: ["Usage"]
---

# Inspect current API usage without spending primary request quota

`GET /api/v1/usage`

Returns the authenticated caller sliding-window request budget and UTC-day usage. This endpoint is authenticated and does not increment the primary Redis rate-limit counter or log itself into the API usage table; it is separately throttled at 100 reads/minute per user to protect the usage-count query.

## Response `200`

Usage budget and counters for the authenticated API key owner.

- Usage
  - `object` 'usage', required
  - `data` object, required
    - `rate_limit` object, required
      - `used` integer, required
      - `limit` integer, required
      - `remaining` integer, required
      - `reset_at` integer, required
      - `window_seconds` integer, required
    - `daily_usage` object, required — UTC-day usage count. Current V1 has no daily hard cap, so limit and remaining are null rather than synthesized.
      - `used` integer, required
      - `limit` integer, nullable, required
      - `remaining` integer, nullable, required
      - `reset_at` integer, required
      - `window_seconds` integer, required
  - `meta` ResponseMeta, required
    - `request_id` string, required — Unique request ID (req_ prefix).
    - `cached` boolean, required
    - `cache_age_s` integer, nullable — Cache age in seconds, null if not cached.

## Other responses

- `401` — unresolved $ref
- `402` — Active Insider subscription required
- `403` — Account access denied
- `423` — Account is locked
- `429` — Rate limit exceeded (100 req/min; batch endpoints also reserve 100 batch item units/min before execution)
- `503` — Redis-backed authenticated rate limiter unavailable; retry after the per-process outage cooldown

## Changes

- **2026-06-15** `5b6d6ff7692c` — 1 breaking
  - removed the media type `application/json` for the response with the status `401`
- **2026-06-01** `a311bdcfd354` — 1 info
  - added the media type `application/json` for the response with the status `401`
- **2026-06-01** `422bd4dc1611` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/0xinsider/apis/0xinsider-api/changes/api/v1/usage/get.md)

---

[API](https://skmtc.dev/0xinsider/apis/0xinsider-api.md) · [All operations](https://skmtc.dev/0xinsider/apis/0xinsider-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/0xinsider/0xinsider-api/revisions/03edbd4f02bd/schema)