Skip to main content
GET /api/v2/storefront/billing/pending-invoice-items Returns invoice line items on your connected Stripe account that have not yet been attached to an invoice — charges accrued since the last invoice was issued. Cursor-paginated: pass the last item’s id as starting_after to fetch the next page. Use this to preview what will land on the next invoice.

​
Request

curl "https://api.interchange.io/api/v2/storefront/billing/pending-invoice-items?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 pending items

​
Response

[
  {
    "id": "ii_1Abc2DefGhiJklMn",
    "description": "Impressions — Globex CTV, June",
    "currency": "usd",
    "amount": 125000,
    "quantity": 1,
    "unitAmount": 125000,
    "date": 1748520000,
    "period": {
      "start": 1748649600,
      "end": 1751241600
    },
    "proration": false,
    "customerId": "cus_GlobexAbc123"
  }
]
amount and unitAmount are in the currency’s smallest unit (cents for usd); unitAmount and customerId may be null. date, period.start, and period.end are Unix timestamps (seconds). 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 invoices

Issued invoices

Get balance transactions

Ledger entries

Billing overview

Stripe Connect concepts