Skip to main content
KweryKwery Docs
HomeDashboard

HTTP status codes

StatusMeaning
401Missing or invalid API key
403Key paused (billing), IP not allowed, or feature not on your plan
402Monthly credits exhausted — upgrade or wait for reset
429Rate limit exceeded — see Rate Limits
501Endpoint not yet deployed
503Service temporarily unavailable

Plan-gated features

Some endpoints require Developer or Business:

FeatureMinimum plan
WebhooksDeveloper
Enhanced address APIsDeveloper
Enhanced transaction parsingBusiness

Free plan users receive 403 when calling gated features.

Example — credits exhausted

{
  "detail": {
    "error": "credits_exhausted",
    "message": "Credit limit of 1,000,000 reached. Upgrade at https://kwery.xyz/pricing"
  }
}

Example — rate limited

{
  "detail": {
    "error": "rate_limit_exceeded",
    "message": "Rate limit exceeded: 5 requests/second for your plan."
  }
}

Example — billing paused

{
  "detail": {
    "error": "api_key_paused",
    "message": "API access is paused due to a past-due payment."
  }
}