Skip to main content
GET /api/v2/storefront/billing/transactions Returns the balance transaction ledger for your connected Stripe account — every charge, fee, and payout movement that touched your balance, newest first. 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/transactions?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 ledger

​
Response

[
  {
    "id": "txn_1Abc2DefGhiJklMn",
    "type": "charge",
    "amount": 500000,
    "currency": "usd",
    "created": 1748520000,
    "description": "Media buy settlement — Q2 CTV",
    "status": "available",
    "fee": 62500,
    "net": 437500
  }
]
amount, fee, and net are in the currency’s smallest unit (cents for usd). created is a Unix timestamp (seconds). This endpoint is cursor-paginated: when meta.hasMore is true, pass meta.cursor as starting_after to get the next page; 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

Get payouts

Payouts to your bank

Get account status

Current balance and verification

Billing overview

Stripe Connect concepts