usage

Get your usage

Your own consumption for the current billing month, and the twelve before it.

GET/v1/usage
Get your usage
curl -sS https://api.cruxal.in/v1/usage \
  -H "Authorization: Bearer $CRUXAL_API_KEY"
{
  "key_prefix": "ck_live_9fA2",
  "tier": "growth",
  "plan_tier": "growth",
  "entitled": true,
  "environment": "live",
  "rate_limit_per_minute": 300,
  "current_month": {
    "period_start": "2026-08-01T00:00:00+05:30",
    "requests": 18122,
    "quota": 500000,
    "remaining": 481878
  },
  "history": [
    {
      "period_start": "2026-07-01T00:00:00+05:30",
      "requests": 402113,
      "quota": 500000,
      "remaining": 97887
    }
  ]
}

Authorization

Authorizationstringheaderrequired

Your API key as a bearer token: Bearer ck_live_…. Keys are server-side credentials and are never accepted in a query string.

Response200 · application/json

key_prefixstringrequired
tierstringrequired

The tier currently being enforced on this key.

plan_tierstring

The tier this key was issued on. Differs from tier only when the account's plan no longer entitles it, in which case tier is what is enforced.

entitledbooleandefault:true

False when the account's plan no longer covers API access. The key keeps working at evaluation limits until the plan is restored.

environmentstringrequired
rate_limit_per_minuteintegerrequired
current_monthV1UsageWindowrequired
historyV1UsageWindow[]

Preceding months, most recent first.