This endpoint returns the product’s balance history rows — the same source
as
GET /hl/v2/transactions — not checkout attempts. id is the balance
history row id, the nominal is credit (with an amount alias), and
successful payments have status: "settled".total is the number of successful transactions for the product: all-time, or
scoped to the startAt/endAt range when those are provided.Authorization
string
required
Example:
Authorization | Bearer Paste-Your-API-Key-HerePath Parameters
string <uuid>
required
Unique product ID whose transactions you want to list.
Query Parameters
string
Filter transactions by status.
string
Filter transactions belonging to a specific customer.
string
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).string
End of the date range to filter by. Accepts a Unix timestamp in milliseconds or
an ISO 8601 date/datetime.
string
Comma-separated list of fields to include in each transaction object. Use it to
trim the payload to only the fields you need.
integer
default:"10"
Number of items to return per page. Defaults to
10, with a maximum of 50.string
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)
integer
Status code form API.
string
Status message that describes the status code.
integer
Number of successful transactions for the product. All-time, or scoped to the
startAt/endAt range when provided (it does not follow other filters).array of object
List of transactions for the product.
boolean
Information on whether there is additional data to be retrieved (true/false).
string | null
Cursor to pass as
startingAfter to fetch the next page. null when there is
no further data.data Structure (Array Of Object)
string<uuid>
Unique ID of the balance history row.
string<uuid>
Alias of
paymentLinkTransactionId — the ID of the underlying payment link
transaction.integer
The amount of credit received from the transaction.
integer
Alias of
credit — the transaction nominal.string
Balance history status (
settled = completed/successful).string
The transaction type (e.g.
generic_link, membership, digital_product).string
The payment method used.
string<uuid>
The unique ID of the customer who made the transaction.
number (timestamp)
The transaction creation time in epoch format (ms).
string<uuid>
The ID of the underlying payment link transaction.
array of object
Additional fees applied to the transaction (empty if none).
string<uuid>
The ID of the product (payment link) the transaction belongs to.
string | null
The subscription ID (if the transaction is a subscription).
string | null
The Xendit transaction ID (if using the Xendit gateway).
object | null
Subscription details (if any).
object | null
Xendit transaction details (if any).
object
Object that stores transaction details related to the payment link.
object | null
Additional custom fields filled by the customer (if any).
object
Customer data that made the transaction.
object
Payment link (product) information used for the transaction.
