List invoices

GET /api/v1/invoices read:inventory

Lists your invoices, newest period first. Invoice numbers embed your account identifier and a per-account sequence that increments across periods — treat invoice_number as opaque and use id for lookups.

Try it GET /api/v1/invoices?limit=10

These inputs are shared across all docs pages, so an id entered here carries over.

response

Not run yet. Press Run to make a live call against https://service.rip.fun (through this demo's server-side proxy; the API key never reaches the browser).

curl (tracks the inputs above)
curl -X GET 'https://service.rip.fun/api/v1/invoices?limit=10' \
  -H 'X-API-Key: rip_…'

Request fields

FieldTypeRequiredDescription
limit / offsetquery intlimit 1..100 default 50; offset 0..10_000 default 0. Non-integer values are a 400 (invalid_pagination). The response carries a pagination object { limit, offset, has_more, next_offset } beside the array

Response fields (data)

FieldDescription
invoices[].id / invoice_numberLookup id + opaque display number, e.g. "INV-2026-05-T{account}-001"
invoices[].period_start / period_end / statusBilling period + DRAFT | SENT | PAID | VOID
invoices[].subtotal_cents / tax_cents / total_cents / currencyAmounts (integer cents)
invoices[].issued_at / due_at / paid_at / payment_terms_daysBilling lifecycle
invoices[].notes / created_at / updated_atFree-form notes + timestamps