Skip to main content
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

​
page
string
default:"1"
Page number.
​
limit
string
default:"10"
Results per page. Maximum 100.
​
type
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

​
success
boolean
​
transactions
object[]
​
counts
object
​
pagination
object