Skip to main content
GET /api/v2/buyer/billing/invoices Lists the consolidated invoices issued to the authenticated buyer customer, newest first. Cursor-paginated.

​
Request

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

​
Parameters

FieldInTypeRequiredNotes
limitqueryintegerNoMaximum results, 1–100 (default 25)
starting_afterquerystringNoCursor — the id of the last invoice from the previous page

​
Response

{
  "invoices": [
    {
      "id": "in_1QabcXYZ",
      "number": "ACME-0042",
      "status": "paid",
      "currency": "usd",
      "amountDue": 1250000,
      "amountPaid": 1250000,
      "amountRemaining": 0,
      "total": 1250000,
      "created": 1748736000,
      "dueDate": 1751328000,
      "periodStart": 1746057600,
      "periodEnd": 1748649600,
      "hostedInvoiceUrl": "https://invoice.interchange.io/in_1QabcXYZ",
      "invoicePdf": "https://invoice.interchange.io/in_1QabcXYZ.pdf",
      "description": "May 2026 consolidated invoice",
      "customerEmail": "ap@acme.com",
      "customerName": "Acme Inc"
    }
  ],
  "hasMore": false,
  "cursor": null
}
FieldTypeNotes
invoicesarrayInvoice rows
invoices[].idstringInvoice ID — pass as starting_after to paginate
invoices[].numberstring | nullHuman-readable invoice number
invoices[].statusstring | nullInvoice status (e.g. paid, open)
invoices[].currencystringISO currency code
invoices[].amountDue / amountPaid / amountRemaining / totalintegerMinor-unit amounts (e.g. cents)
invoices[].createdintegerUnix epoch seconds
invoices[].dueDate / periodStart / periodEndinteger | nullUnix epoch seconds
invoices[].hostedInvoiceUrl / invoicePdfstring | nullLinks to the hosted invoice and PDF
invoices[].descriptionstring | nullFree-text description
invoices[].customerEmail / customerNamestring | nullBilling contact details
hasMorebooleanWhether more pages exist
cursorstring | nullCursor for the next page, or null

​
Errors

  • 400 VALIDATION_ERROR — limit out of range.
  • 401 UNAUTHORIZED — missing or invalid bearer token.
See Errors for the full error contract.

Billing tasks

All billing operations

List pending invoice items

Accrued, not yet billed

Billing overview

Amounts, timestamps, pagination