curl "https://api.vouchmark.com/v1/wallet/transactions?type=top_ups&limit=10" \
-H "Authorization: Bearer $TOKEN"
{
"success": true,
"transactions": [
{
"id": "...",
"referenceNumber": "...",
"amount": 50000,
"vat": 3750,
"totalAmount": 53750,
"status": "successful",
"type": "top_up",
"paymentMethod": "Paystack",
"createdAt": "2026-05-18T10:00:00Z"
}
],
"counts": {
"totalTopUps": 12,
"totalUsage": 40
},
"pagination": {
"page": 1,
"limit": 10,
"total": 52,
"totalPages": 6,
"hasNextPage": true,
"hasPrevPage": false
}
}
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,
"transactions": [
{
"id": "...",
"referenceNumber": "...",
"amount": 50000,
"vat": 3750,
"totalAmount": 53750,
"status": "successful",
"type": "top_up",
"paymentMethod": "Paystack",
"createdAt": "2026-05-18T10:00:00Z"
}
],
"counts": {
"totalTopUps": 12,
"totalUsage": 40
},
"pagination": {
"page": 1,
"limit": 10,
"total": 52,
"totalPages": 6,
"hasNextPage": true,
"hasPrevPage": false
}
}
Returns a paginated list of wallet transactions, ordered by most recent first.
Transaction amounts in this response are in naira (NGN), not kobo. Divide a kobo amount by 100 to get naira.
Query parameters
string
default:"1"
Page number.
string
default:"10"
Results per page. Maximum 100.
string
Filter by category. One of
top_ups or usage.curl "https://api.vouchmark.com/v1/wallet/transactions?type=top_ups&limit=10" \
-H "Authorization: Bearer $TOKEN"
{
"success": true,
"transactions": [
{
"id": "...",
"referenceNumber": "...",
"amount": 50000,
"vat": 3750,
"totalAmount": 53750,
"status": "successful",
"type": "top_up",
"paymentMethod": "Paystack",
"createdAt": "2026-05-18T10:00:00Z"
}
],
"counts": {
"totalTopUps": 12,
"totalUsage": 40
},
"pagination": {
"page": 1,
"limit": 10,
"total": 52,
"totalPages": 6,
"hasNextPage": true,
"hasPrevPage": false
}
}
Response fields
boolean
object[]