curl "https://api.vouchmark.com/v1/wallet/transactions?type=top_ups&limit=10" \
-H "Authorization: Bearer $TOKEN"
{
"success": true,
"message": "Transactions retrieved successfully",
"data": {
"transactions": [
{
"id": "...",
"referenceNumber": "...",
"amountKobo": 5000000,
"vatKobo": 375000,
"totalAmountKobo": 5375000,
"status": "successful",
"type": "top_up",
"paymentMethod": "Paystack",
"createdAt": "2026-05-18T10:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 52,
"totalPages": 6,
"hasNext": true,
"hasPrev": false
},
"counts": {
"topUps": 12,
"usage": 40
}
}
}
Wallet & Billing
List transactions
View wallet transaction history: top-ups and usage.
GET
/
v1
/
wallet
/
transactions
curl "https://api.vouchmark.com/v1/wallet/transactions?type=top_ups&limit=10" \
-H "Authorization: Bearer $TOKEN"
{
"success": true,
"message": "Transactions retrieved successfully",
"data": {
"transactions": [
{
"id": "...",
"referenceNumber": "...",
"amountKobo": 5000000,
"vatKobo": 375000,
"totalAmountKobo": 5375000,
"status": "successful",
"type": "top_up",
"paymentMethod": "Paystack",
"createdAt": "2026-05-18T10:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 52,
"totalPages": 6,
"hasNext": true,
"hasPrev": false
},
"counts": {
"topUps": 12,
"usage": 40
}
}
}
Returns a paginated list of wallet transactions, ordered by most recent first.
Transaction amounts in this response are integer kobo, not naira (1 NGN = 100 kobo). Divide a kobo amount by 100 to get naira.
Query parameters
curl "https://api.vouchmark.com/v1/wallet/transactions?type=top_ups&limit=10" \
-H "Authorization: Bearer $TOKEN"
{
"success": true,
"message": "Transactions retrieved successfully",
"data": {
"transactions": [
{
"id": "...",
"referenceNumber": "...",
"amountKobo": 5000000,
"vatKobo": 375000,
"totalAmountKobo": 5375000,
"status": "successful",
"type": "top_up",
"paymentMethod": "Paystack",
"createdAt": "2026-05-18T10:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 52,
"totalPages": 6,
"hasNext": true,
"hasPrev": false
},
"counts": {
"topUps": 12,
"usage": 40
}
}
}
Response fields
Show data
Show data
