Skip to main content
GET /api/v2/storefront/billing/invoices Returns invoices issued on your connected Stripe account, newest first, with amounts, status, billing period, and hosted PDF links. Cursor-paginated: pass the last item’s id as starting_after to fetch the next page.

​
Request

curl "https://api.interchange.io/api/v2/storefront/billing/invoices?limit=25" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
limitintegerNoQuery param. Maximum results, 1–100. Default 25
starting_afterstringNoQuery param. Cursor — the id of the last item from the previous page
targetCustomerIdnumberNoQuery param. Parent customers read a child account’s invoices

​
Response

[
  {
    "id": "in_1Abc2DefGhiJklMn",
    "number": "ACME-0042",
    "status": "paid",
    "currency": "usd",
    "amountDue": 500000,
    "amountPaid": 500000,
    "amountRemaining": 0,
    "total": 500000,
    "created": 1748520000,
    "dueDate": 1751112000,
    "periodStart": 1746057600,
    "periodEnd": 1748649600,
    "hostedInvoiceUrl": "https://invoice.stripe.com/i/acct_1Abc/test_abc123",
    "invoicePdf": "https://pay.stripe.com/invoice/acct_1Abc/test_abc123/pdf",
    "description": "May 2026 media settlement",
    "customerEmail": "ap@globex.example",
    "customerName": "Globex Corporation"
  }
]
Amounts are in the currency’s smallest unit (cents for usd). created, dueDate, periodStart, and periodEnd are Unix timestamps (seconds); dueDate and the period fields may be null. number, status, hostedInvoiceUrl, invoicePdf, description, customerEmail, and customerName may also be null. This endpoint is cursor-paginated: when meta.hasMore is true, pass meta.cursor as starting_after; see Pagination.

​
Errors

  • 400 VALIDATION_ERROR — limit outside 1–100, no Stripe account provisioned, or Stripe is not configured on the server.
See Errors for the full error contract.

Billing tasks

All billing operations

List pending invoice items

Line items not yet on an invoice

Get balance transactions

Ledger entries

Billing overview

Stripe Connect concepts