Request this endpoint to get all transactions or select specific filter and search parameters. You can filter by date, type, or status. And you can search by reference, product id, or account identifier. The returned result will be paginated and ordered by the created date.
Use API key permission Transaction Read to perform this request
Sample curl Request:
curl https://api.xendit.co/transactions?types=PAYMENT&statuses=SUCCESS&channel_categories=EWALLET&channel_categories=RETAIL_OUTLET&limit=2 -X GET \
-u xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg==:
The sub-account user-id that you want to make this transaction for.
This header is only used if you have access to xenPlatform. See xenPlatform for more information
The type of the transaction
The status of the transaction
The channel of the transactions that will be filtered. If not specified, all transaction channel will be returned.
Reference that will be searched. Search by reference is case sensitive and can be partial match.
Product_id that will be searched. Product_id search is an exact match and case sensitive.
Account identifier that will be searched. Account identifier search is exact match case sensitive.
Currency filter for transaction-related endpoints and reports. The following currencies are commonly supported:
- IDR, PHP, USD, VND, THB, MYR, SGD, EUR, GBP, HKD, AUD However, any applicable ISO 4217 currency code may be used depending on your account and transaction type. This parameter is optional; if omitted, all currencies will be included.
Transaction amount to search. This will be exact match.
Start time of transaction by created date. If not specified, will list all dates.
End time of transaction by created date. If not specified, will list all dates.
Start time of transaction by updated date. If not specified, will list all dates.
End time of transaction by updated date. If not specified, will list all dates.
A limit on the number of transactions to be returned for each request.
Id of the immediately previous item. Use this with links on the response for pagination.
ID of the immediately following item.
Successful operation
{
"has_more": false,
"data": [
{
"id": "txn_3365895e-3cc1-490a-b48c-2757ce8ab0e5",
"product_id": "cmanl0vtp000101u9lqbvn7im",
"type": "CONVERSION",
"status": "SUCCESS",
"channel_category": "OTHER",
"channel_code": "DEFAULT",
"reference_id": "cmanl0vtp000101u9lqbvn7im",
"account_identifier": null,
"currency": "SGD",
"amount": 6.55,
"net_amount": 6.55,
"net_amount_currency": "SGD",
"cashflow": "MONEY_IN",
"settlement_status": "SETTLED",
"estimated_settlement_time": "2025-05-14T06:51:08.999Z",
"business_id": "675bdaf542c2f448122e71d5",
"created": "2025-05-14T06:51:08.998Z",
"updated": "2025-05-14T06:52:34.196Z",
"fee": {
"xendit_fee": 0,
"value_added_tax": 0,
"xendit_withholding_tax": 0,
"third_party_withholding_tax": 0,
"status": "NOT_APPLICABLE"
}
},
{
"id": "txn_c3d31125-1a06-4563-b7aa-b574beb7e2f9",
"product_id": "cm99a3by9000x01qu51tf1t85",
"type": "CONVERSION",
"status": "FAILED",
"channel_category": "OTHER",
"channel_code": "DEFAULT",
"reference_id": "cm99a3by9000x01qu51tf1t85",
"account_identifier": null,
"currency": "SGD",
"amount": 6.8,
"net_amount": 5.1,
"net_amount_currency": "USD",
"cashflow": "MONEY_IN",
"settlement_status": "PENDING",
"estimated_settlement_time": "2025-04-09T01:56:38.519Z",
"business_id": "675bdaf542c2f448122e71d5",
"created": "2025-04-09T01:56:38.517Z",
"updated": "2025-04-09T01:58:05.027Z",
"fee": {
"xendit_fee": 0,
"value_added_tax": 0,
"xendit_withholding_tax": 0,
"third_party_withholding_tax": 0,
"status": "NOT_APPLICABLE"
}
},
{
"id": "txn_8c36b107-a52e-478a-8dde-59bfa7212bc6",
"product_id": "d2845324-50d1-41bc-8583-0b888456ebfe",
"type": "PAYMENT",
"status": "SUCCESS",
"channel_category": "EWALLET",
"channel_code": "MY_SHOPEEPAY",
"reference_id": "mylitt-aa7650f9b1364433-a7e7c4809b379e4e-1742983783200",
"account_identifier": null,
"currency": "MYR",
"amount": 2.22,
"net_amount": 2.2,
"net_amount_currency": "MYR",
"cashflow": "MONEY_IN",
"settlement_status": "SETTLED",
"estimated_settlement_time": "2025-03-28T10:09:54.915Z",
"business_id": "668643d45f3fffd3c0d3b1ef",
"created": "2025-03-26T10:09:55.171Z",
"updated": "2025-03-28T10:10:53.276Z",
"fee": {
"xendit_fee": 0.02,
"value_added_tax": 0,
"xendit_withholding_tax": 0,
"third_party_withholding_tax": 0,
"status": "NOT_APPLICABLE"
}
},
{
"id": "txn_pay_1234567890abcdef",
"product_id": "py-123e4567-e89b-12d3-a456-426614174000",
"type": "PAYMENT",
"status": "SUCCESS",
"channel_category": "EWALLET",
"channel_code": "ID_SHOPEEPAY",
"reference_id": "payref-123456",
"account_identifier": null,
"currency": "IDR",
"amount": 100000,
"net_amount": 99000,
"net_amount_currency": "IDR",
"cashflow": "MONEY_IN",
"settlement_status": "SETTLED",
"estimated_settlement_time": "2025-06-01T10:00:00Z",
"business_id": "1234567890abcdef",
"created": "2025-06-01T09:59:00Z",
"updated": "2025-06-01T10:01:00Z",
"fee": {
"xendit_fee": 1000,
"value_added_tax": 0,
"xendit_withholding_tax": 0,
"third_party_withholding_tax": 0,
"status": "COMPLETED"
},
"product_data": {
"capture_id": "cap-123e4567-e89b-12d3-a456-426614174002",
"payment_request_id": "pr-123e4567-e89b-12d3-a456-426614174003"
}
}
],
"links": []
}Indicates whether there are more items to be queried with after_id of the last item from the current result. When true, use the HATEOAS links for pagination.
Unique ID generated by Xendit for the particular file
The product_id of transaction. Product id will have different prefix for each different product. You can use this id to match the transaction from this API to each product API.
The type of the transactions. Here are the descriptions:
DISBURSEMENT: The disbursement of money-out transaction.PAYMENT: The payment that includes all variation of money-in transaction.REMITTANCE_PAYOUT: The remittance pay-out transaction.TRANSFER: The transfer transaction between xendit account. This can be transfer in or out.REFUND: A refund transaction created to refund amount from money-in transactionWITHDRAWAL: A withdrawal transaction for money-out operationsTOPUP: A top-up transaction for adding money to account balanceCONVERSION: Balance conversion transactions between different currencies
The channel of the transaction that is used. See channel codes for the list of available per channel categories.
A Reference ID from merchants to identify their request.
Account identifier of transaction. The format will be different from each channel. For example, on BANK channel it will be account number and on CARD it will be masked card number.
The currency to filter.
The amount of transaction. The number of decimal place will be different for each currency according to ISO 4217.
The net amount of transaction after it deducted with fee/vat.
The currency of the net amount after fees and taxes are applied.
Representing whether the transaction is money in or money out For transfer, the transfer out side it will shows up as money out and on transfer in side in will shows up as money-in.
Available values are MONEY_IN for money in and MONEY_OUT for money out.
The status of the transaction. Here's the description:
PENDING: The transaction is still pending to be processed. This refers to money out-transaction when the amount is still on hold.SUCCESS: The transaction is successfully sent for money-out or already arrives on money-in.FAILED: The transaction failed to send/receive.VOIDED: The money-in transaction is voided by customer.REVERSED:The transaction is reversed by Xendit.
The channel category of the transaction to identify the source of the transaction. Here's the description:
DISBURSEMENTandREMITTANCE_PAYOUT:BANKandCASHPAYMENT:CARDS,CARDLESS_CREDIT,DIRECT_DEBIT,EWALLET,PAYLATER,QR_CODE,RETAIL_OUTLET,VIRTUAL_ACCOUNTTRANSFER:XENPLATFORMCONVERSION:OTHER
Unique ID generated by Xendit for the particular file
Transaction created timestamp on UTC+0
Transaction updated timestamp on UTC+0
Amount of the Xendit fee for this transaction.
Amount of the VAT for this transaction.
Amount of the Xendit Withholding Tax for this transaction if applicable. See Tax Documentation for more information.
Amount of the 3rd Party Withholding Tax for this transaction if applicable.
Status of the fee processing. NOT_APPLICABLE means no fees are applicable for this transaction.
Status of the settlement.
null: Settlement status is not applicable or not yet determinedPENDING: Transaction amount has not been settled to merchant's balanceEARLY_SETTLED: Transaction has been settled early to merchant's balanceSETTLED: Transaction has been settled to merchant's balance
Estimated settlement time will only apply to money-in transactions.
For money-out transaction, value will be NULL
Estimated settlement time in which transaction amount will be settled to merchant's balance.
Additional metadata for payment V3 transactions. This object contains product-specific identifiers and is only included when at least one field has a value. All fields are nullable and conditionally populated based on the transaction type and payment flow.
The capture ID for payment V3 transactions. Present for captured payments.
The payment request ID for payment V3 transactions. Present for payments created via payment V3 payment requests.
The reusable payment link ID. Present for payments made through reusable payment links.
The invoice/payment link ID. Present for payments associated with payment links.
HATEOAS links for pagination. Contains navigation links when more results are available.
URI for the next page of results.
Link relationship type. Value will be 'next' for pagination.
HTTP method to use. Value will be 'GET'.
Inputs are failing validation. The errors field contains details about which fields are violating validation.