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
}
Earnings
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
}
Only for programs where ZBD tracks earnings. If you track earnings yourself, this returns
403 feature_not_enabled.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?