Billing

List a user's billing events

Admin-only endpoint that returns billing audit events for a user, with optional filters for time range, endpoint, request id, event status, and billable flag. Invalid event_status values and reversed time ranges return invalid params.

get/admin/billing/users/{id}/events

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/admin/billing/users/{id}/events
  • Auth: API key in header x-api-key

Path parameters

idstring required

User id

Query parameters

limitinteger

Maximum records to return. Defaults to 50 and clamps to 100.

fromstring

Created-at lower bound in RFC3339 format

tostring

Created-at upper bound in RFC3339 format

endpointstring

Normalized endpoint or API path

request_idstring

Request id to inspect

event_status'reserved' | 'charged' | 'non_billable' | 'failed'

Billing event status

billableboolean

Filter billable or non-billable events

Headers

x-api-keystring required

Admin API key required unless an Admin JWT is already present

Response

Billing events

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": [
    {
      "billable": true,
      "charged_at": "2026-04-16T10:00:00Z",
      "created_at": "2026-04-16T10:00:00Z",
      "credit_cost": 3,
      "credits_remaining_after": 398750,
      "credits_remaining_before": 398753,
      "credits_used_after": 1250,
      "credits_used_before": 1247,
      "daily_key": "2026-04-16",
      "endpoint": "google/search",
      "event_status": "charged",
      "finalized_at": "2026-04-16T10:00:00Z",
      "idempotency_key": "req-1:google/search",
      "method": "GET",
      "period_key": "2026-04",
      "plan": "Pro",
      "principal_type": "user",
      "request_id": "req-1",
      "route_pattern": "/api/v1/google/search",
      "status_code": 200,
      "user_id": "user-1"
    }
  ],
  "msg": "OK"
}

Changes

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