Billing

Per-user blocked-request tally

Admin-only endpoint returning the per-user tally of pre-handler billing rejections (HTTP 402 quota / 429 rate-limit) for a UTC day, ranked by count. These blocks never reach the request-usage index or the billing-events log, so this is the only per-user view of who is being throttled or has hit their cap — use it to spot a capped client retry-looping. Defaults to today (UTC); tallies are retained for 48h.

get/admin/billing/rejections

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/admin/billing/rejections
  • Auth: API key in header x-api-key

Query parameters

datestring

UTC day to report, YYYY-MM-DD. Defaults to today.

reason'daily_credit_limit' | 'insufficient_credits' | 'rate_limited' | 'ip_rate_limited'

Filter to one rejection reason

limitinteger

Max users to return (1-500, default 50)

Headers

x-api-keystring required

Admin API key required unless an Admin JWT is already present

Response

Per-user rejection tally

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "blocked_users": 1,
    "date": "2026-07-13",
    "total_rejections": 25,
    "users": [
      {
        "total": 25,
        "user_id": "12ed27cb603301bceaf5739ef208a433"
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.