usage

Get your usage and quota

Return the calling account's current-window usage against its quota.

Reports the account total — the sum across every API key you own, which is the number quota enforcement actually compares against. Holding several keys does not raise the allowance; they share one. The same numbers back the RateLimit-* headers on every metered response, so this endpoint and a 429 can never disagree.

An account with no requests yet in the window reports request_count: 0. This read is itself exempt from metering, so calling it does not consume quota — it stays reachable even while you are over cap.

get/v1/usage

Request

  • Base URL: https://api.noms.sh
  • URL: https://api.noms.sh/v1/usage
  • Auth: API key in header X-API-Key

Response

Successful Response

Example response

{
  "data": {
    "period_end": "2026-06-17T10:00:00Z",
    "quota_window": "daily",
    "remaining": 208,
    "request_count": 42,
    "request_quota": 250,
    "tier": "taster"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.