Docs

Key status

GET /v1/key — limits, current-window usage and what's left, without opening the dashboard.

GEThttps://iranrouter.com/v1/key

This key's limits, current-window usage and what is left — without opening the dashboard. Enough for an agent to check headroom before starting heavy work.

json

{
  "object": "key",
  "plan": "pro",
  "limits": {
    "requests_per_minute": 60,
    "requests_per_hour": 1000,
    "requests_per_day": 10000,
    "tokens_per_minute": 200000,
    "monthly_budget_rial": null
  },
  "usage": {
    "requests_this_hour": 42,
    "requests_today": 380,
    "spend_mtd_rial": 1840000
  },
  "remaining": {
    "requests_this_hour": 958,
    "requests_today": 9620,
    "budget_rial": null
  }
}

null means unlimited, not zero. An agent that reads null as zero stops itself for no reason.

How the limits work →