Billing

List current user's billing events

Returns recent billing audit events for the authenticated 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/billing/me/events

Request

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

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

API key required unless an authenticated 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.