List recent invoices

GEThttps://app.speybooks.com/api/v1/billing/invoices

Lists the organisation's recent Stripe invoices, newest first, for display on the billing page. Stripe drafts and voids are excluded: drafts are Stripe-internal until finalised, and voids are noise on a customer-facing list. Amounts are integer minor units (pence) passed through verbatim, with no arithmetic on this path. Each invoice carries a Stripe-hosted page URL and a direct PDF link.

An organisation that has not yet completed checkout has no Stripe customer and receives an empty list, not an error. Full invoice history and payment-method management live in the billing portal (createBillingPortalSession).

Response

200Recent Stripe invoices for the organisation, newest first. Empty until the first invoice is finalised.

Show response fields

invoicesarray<object>

Show child attributes

createdstring

ISO 8601 creation timestamp

currencystring

ISO currency code, lowercase (gbp)

hostedInvoiceUrlstringnullable

Stripe-hosted invoice page

idstring

Stripe invoice id

invoicePdfstringnullable

Direct PDF download URL

numberstringnullable

Human-readable invoice number

statusstring

Invoice status (draft and void are never listed)

openpaiduncollectible

totalPenceinteger

Invoice total in minor units (pence)

RequestGET/v1/billing/invoicescurl

curl https://api.speybooks.com/v1/billing/invoices \
  -H "Authorization: Bearer sk_test_..."

Response200

{
  "success": true,
  "data": {
    "invoices": [
      {
        "id": "in_1ABC...",
        "number": "SPEY-0001",
        "status": "paid",
        "created": "2026-09-03T16:53:30.000Z",
        "totalPence": 2500,
        "currency": "gbp",
        "hostedInvoiceUrl": "https://invoice.stripe.com/i/...",
        "invoicePdf": "https://pay.stripe.com/invoice/.../pdf"
      }
    ]
  }
}