---
title: "List a user's billing events"
method: GET
path: "/admin/billing/users/{id}/events"
tags: ["Billing"]
---

# List a user's billing events

`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`

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.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `from` string
- `to` string
- `endpoint` string
- `request_id` string
- `event_status` 'reserved' | 'charged' | 'non_billable' | 'failed'
- `billable` boolean

## Headers

- `x-api-key` string, required

## Response `200`

Billing events

- BillingBillingEventsResponseDoc
  - `code` integer
  - `data` BillingBillingEventDoc[]
    - `billable` boolean
    - `charged_at` string
    - `created_at` string
    - `credit_cost` integer
    - `credits_remaining_after` integer
    - `credits_remaining_before` integer
    - `credits_used_after` integer
    - `credits_used_before` integer
    - `daily_key` string
    - `endpoint` string
    - `event_status` string
    - `failure_reason` string
    - `finalized_at` string
    - `idempotency_key` string
    - `method` string
    - `non_billable_reason` string
    - `overage_credits_delta` integer
    - `period_key` string
    - `plan` string
    - `principal_type` string
    - `request_id` string
    - `route_pattern` string
    - `status_code` integer
    - `user_id` string
  - `msg` string

## Other responses

- `400`: Invalid query parameters
- `401`: Authentication required
- `403`: Admin plan required
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)