---
title: "List the viewer's credit-ledger events (newest-first, cursor paginated)"
method: GET
path: "/v1/billing/history"
tags: ["Billing"]
---

# List the viewer's credit-ledger events (newest-first, cursor paginated)

`GET /v1/billing/history`

## Request

- Base URL: `https://api.lizzflix.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lizzflix.xyz/v1/billing/history`
- Auth: none declared

## Query parameters

- `limit` string
- `cursor` string

## Response `200`

Billing history page

- BillingHistoryResponse
  - `items` BillingHistoryItem[], required
    - `id` string, required
    - `kind` 'grant' | 'charge' | 'refund' | 'renewal' | 'other', required
    - `eventType` string, required
    - `amountCredits` number, required
    - `description` string, required
    - `sourceRef` string, nullable, required
    - `createdAt` string, required
  - `nextCursor` string, nullable, required

## Other responses

- `401`: Unauthorized

---

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