Skip to main content
GET
List billing invoices

Authorizations

Authorization
string
header
required

JWT authentication token

Query Parameters

limit
integer
default:25

Maximum number of invoices to return (default 25, max 100)

Required range: 1 <= x <= 100
starting_after
string

Cursor for pagination - Stripe invoice ID to start after

type
enum<string>

Filter by invoice type; omit to return all

Available options:
purchase,
topup,
subscription

Response

List of invoices with credit context and lifetime totals

currency
string
required

Currency code aggregated across credit purchases (defaults to "usd").

has_more
boolean
required

Whether more invoices exist beyond this page.

invoice_history
object[]
required

All Stripe invoices for the authenticated user's Stripe customer, enriched per-row with credit context when a matching local credit_purchase event exists.

total_amount_cents
integer<int64>
required

Lifetime total spent in cents across credit purchases.

total_amount_display
string
required

Formatted lifetime total (e.g. "$1,250.00").

total_purchases
integer
required

Lifetime count of credit_purchase events for this resource.