---
title: "Billing history (paginated usage events)"
method: GET
path: "/api/v1/usage"
---

# Billing history (paginated usage events)

`GET /api/v1/usage`

Returns billing history as a paginated list of usage events. Each event
represents one charge — either a completed async job or a synchronous billed
API call. Use `sort` and `order` to control the result order.

## Query parameters

- `page` integer
- `limit` integer
- `sort` 'id' | 'created_at' | 'eur_cents_charged' | 'credits_charged' | 'units'
- `order` 'asc' | 'desc'

## Response `200`

Paginated billing history.

- object
  - `pagination` Pagination, required
    - `limit` integer, required — Page size echoed back from the request.
    - `order` 'asc' | 'desc', required — Sort direction.
    - `page` integer, required — 1-indexed current page number echoed back from the request.
    - `sort` 'id' | 'created_at' | 'eur_cents_charged' | 'credits_charged' | 'units', required — Column the rows are sorted by.
    - `total` integer, required — Total matching rows for the authenticated user (full set, not just this page).
    - `total_pages` integer, required — ceil(total / limit). Zero when total is zero.
  - `usage_events` UsageEvent[], required
    - `async_job_id` string, uuid, nullable — The `async_jobs.id` (UUID) for async pipeline charges; null for synchronous endpoint charges.
    - `created_at` string, required — Timestamp of the charge (ISO 8601).
    - `credits_charged` integer, required — Whole credits debited for this row before EUR conversion.
    - `endpoint` string — Billing route key (e.g. `drivers`, `alerts`, or a forecast pipeline type).
    - `eur_cents_charged` integer, required — EUR cents debited for this row (1 EUR = 100 cents).
    - `id` integer, required — Auto-increment row identifier.
    - `units` integer, required — Metered quantity — item count for per-unit pricing, 1 for flat-fee strategies.

## Other responses

- `400` — Invalid query parameter — bad `page`, `limit`, `sort`, or `order` value.
- `401` — Missing or invalid bearer token.

---

[API](https://skmtc.net/sybilion/apis/sybilion-api.md) · [All operations](https://skmtc.net/sybilion/apis/sybilion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sybilion/sybilion-api/versions/2ba1f4c6f25d/schema)