Skip to main content
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.
Endpoint:

Authorization

string
required
Example:Authorization | Bearer Paste-Your-API-Key-Here

Path 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 Response

Main 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).
The ID of the underlying payment link transaction.
array of object
Additional fees applied to the transaction (empty if none).
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 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.
Payment link (product) information used for the transaction.