Skip to main content
GET /api/v2/buyer/billing/pending-invoice-items Lists the pending line items that have accrued and will appear on the next consolidated invoice issued to the authenticated buyer customer. Cursor-paginated.

​
Request

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

​
Parameters

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

​
Response

{
  "items": [
    {
      "id": "ii_1QabcXYZ",
      "description": "Media spend — Q2 Tech Launch",
      "currency": "usd",
      "amount": 480000,
      "quantity": 1,
      "unitAmount": 480000,
      "date": 1749081600,
      "period": { "start": 1748736000, "end": 1751328000 },
      "proration": false,
      "customerId": "100"
    }
  ],
  "hasMore": false,
  "cursor": null
}
FieldTypeNotes
itemsarrayPending line items
items[].idstringItem ID — pass as starting_after to paginate
items[].descriptionstring | nullLine description
items[].currencystringISO currency code
items[].amountintegerTotal minor-unit amount for the line (e.g. cents)
items[].quantityintegerQuantity billed
items[].unitAmountinteger | nullPer-unit minor-unit amount
items[].dateintegerUnix epoch seconds
items[].periodobject{ start, end }, Unix epoch seconds
items[].prorationbooleanWhether the line is a proration adjustment
items[].customerIdstring | nullCustomer the line is attributed to
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 invoices

Issued consolidated invoices

Billing overview

Amounts, timestamps, pagination