List transactions

X-API-Key

GET/transactions

Paginated list of API transactions for your account. Useful for reconciliation dashboards.

Language

curl -X GET "https://api.vendpower.ng/api/v1/transactions?page=1&per_page=20" \
  -H "X-API-Key: YOUR_X_API_KEY" \
  -H "Accept: application/json"

Authentication

Send your approved API key on every request. Keep it on your server only.

Header	Value	Required
X-API-Key	YOUR_X_API_KEY	Yes
Accept	application/json	Recommended

Authentication failures (401 / 403 / 429) are listed in Authentication.

Parameters

Query parameters

Name	Type	Required	Description
page	integer	No	Page number (default `1`)
per_page	integer	No	Items per page (default server limit)
status	string	No	Filter by status e.g. `success`, `failed`
category	string	No	Filter by category e.g. `airtime`, `electricity`

Responses

200 OK — Page

{
  "success": true,
  "message": "Transactions retrieved.",
  "data": [
    {
      "id": 88001,
      "reference": "VP_AIRTIME_001",
      "idempotency_key": "VP_AIRTIME_001",
      "status": "success",
      "category": "airtime",
      "amount": 1000,
      "charge": 1000
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 5,
    "per_page": 20,
    "total": 92
  }
}