Get transaction

X-API-Key

GET/transactions/{id}

Shared across electricity, betting, cable, data, airtime, and Vend Airtime to Cash. Path accepts numeric id or the VP reference string.

Language

curl -X GET "https://api.vendpower.ng/api/v1/transactions/VP_AIRTIME_001" \
  -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

Path parameters

Name	Type	Required	Description
id	string	Yes	Transaction id (digits) or reference / `idempotency_key`

Responses

200 OK — Found

{
  "success": true,
  "message": "Transaction retrieved.",
  "data": {
    "id": 88001,
    "reference": "VP_AIRTIME_001",
    "idempotency_key": "VP_AIRTIME_001",
    "status": "success",
    "category": "airtime",
    "amount": 1000,
    "charge": 1000,
    "biller_name": "MTN",
    "customer_phone": "08031234567"
  }
}

Notes

For airtime/data, the MSISDN is customer_phone (not meter_number).
Use POST /transactions/{id}/requery to force an upstream status refresh.