---
title: "Key usage & quota"
method: GET
path: "/api/v1/usage"
---

# Key usage & quota

`GET /api/v1/usage`

## Request

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

Free. Remaining token balance and plan capabilities for the calling key — pre-flight a metered call.

## Response `200`

Usage snapshot.

- object
  - `tokens` object
    - `allocation` number
    - `used` number
    - `remaining` number
  - `plan` object
    - `api_llm_access` boolean
  - `satellite_pass` object, nullable: The satellite pass in force (VIIRS / NISAR viewing on a plan without them), or null.
    - `covers` string[]
    - `expires_at` string, date-time

## Other responses

- `401`: Error response with a stable machine-readable code.
- `403`: Error response with a stable machine-readable code.
- `429`: Error response with a stable machine-readable code.

---

[API](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api.md) · [All operations](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api/revisions/5cf3f2bed5a2?raw)