curl "https://api.zbdpay.com/api/v1/transactions?user_id=4ac4fd8a-cc2c-4d03-af09-a76f4e89d652" \
-H "x-api-key: YOUR_API_KEY"
{
"success": true,
"message": "Transactions retrieved.",
"data": {
"transactions": [
{
"transaction_id": "txn_3b10",
"type": "reward",
"status": "completed",
"user_id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652",
"amount": 1000,
"currency": "USD",
"reference_id": "season_3_win",
"created_at": "2026-10-01T18:20:00Z"
}
],
"next_cursor": null
},
"error": null
}
Transactions
List Transactions
Read transactions for one user or across your program, whichever call created them.
GET
/
api
/
v1
/
transactions
curl "https://api.zbdpay.com/api/v1/transactions?user_id=4ac4fd8a-cc2c-4d03-af09-a76f4e89d652" \
-H "x-api-key: YOUR_API_KEY"
{
"success": true,
"message": "Transactions retrieved.",
"data": {
"transactions": [
{
"transaction_id": "txn_3b10",
"type": "reward",
"status": "completed",
"user_id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652",
"amount": 1000,
"currency": "USD",
"reference_id": "season_3_win",
"created_at": "2026-10-01T18:20:00Z"
}
],
"next_cursor": null
},
"error": null
}
Use this to show a user their history in your product, or to reconcile across your program.
Cash outs also appear in List Payouts, with their payout status.
Configuration
Header Parameters
string
required
Your ZBD API key.
Query Parameters
string
Only this user’s transactions.
string
Only one type, for example
reward, debit, purchase, gift, or marketplace_sale.string
Only the transaction with your reference.
string
Only transactions in this project.
string
ISO 8601 start of the date range.
string
ISO 8601 end of the date range.
integer
Page size.
string
The
next_cursor from the previous page.curl "https://api.zbdpay.com/api/v1/transactions?user_id=4ac4fd8a-cc2c-4d03-af09-a76f4e89d652" \
-H "x-api-key: YOUR_API_KEY"
{
"success": true,
"message": "Transactions retrieved.",
"data": {
"transactions": [
{
"transaction_id": "txn_3b10",
"type": "reward",
"status": "completed",
"user_id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652",
"amount": 1000,
"currency": "USD",
"reference_id": "season_3_win",
"created_at": "2026-10-01T18:20:00Z"
}
],
"next_cursor": null
},
"error": null
}
Was this page helpful?