This endpoint returns the merchant’s balance history, not the transactions
created by
payments/create / invoices/create. Consequences:idis the balance-history row id. The underlying transaction id is inpaymentLinkTransactionIdand thetransactionIdalias.- The nominal is
credit; anamountalias is provided with the same value. - Rows appear once the payment is settled (a small lag after a successful
payment is expected). To narrow to paid rows use
status=settled(orstatus=paidfor the freshly settled view).
Date fields such as
createdAt (and updatedAt/expiredAt on sibling list
and detail endpoints) are returned as Unix timestamps in milliseconds
(numbers), not ISO 8601 strings. Convert with new Date(value).toISOString()
when an ISO string is required.Authorization
Query Parameters
Start of the date range to filter by. Accepts a Unix timestamp in milliseconds
or an ISO 8601 date/datetime (e.g.
1755993600000, 2026-08-24, or
2026-08-24T00:00:00.000Z).End of the date range to filter by. Accepts a Unix timestamp in milliseconds or
an ISO 8601 date/datetime.
Cursor for forward pagination. Pass the
nextStartingAfter value from the
previous response (a Unix timestamp in milliseconds, as a string) to fetch the
next page.Response
Successful ResponseMain Structure (Root)
Total number of successful transactions for the account. All-time, or scoped
to the
startAt/endAt range when provided (it does not follow the other
filters).Cursor to pass as
startingAfter to fetch the next page. null when there is
no further data.data Structure (Array Of Object)
The ID of the underlying payment link transaction — the id returned by
payments/create or invoices/create.