List purchases
GET
https://instantrecharge.com.ng/api/v1/transactionsReturns your purchases, newest first. Use status to find orders that need attention, for example pending or refunded.
Requires your API key.
Headers
| Name | Type | Description |
|---|---|---|
Authorizationrequired | string | Bearer followed by your API key. |
Query parameters
| Name | Type | Description |
|---|---|---|
limit | integer | How many to return, 1–100. Default 50. |
status | string | Only orders with this status.One of: paid, processing, pending, delivered, refund_due, refunding, refunded, failed |
Responses
200Your purchases.
{
"data": [
{
"id": "IR7F3A9C21B0",
"reference": "inv-2026-000184",
"service": "MTN N100 100MB - 24 hrs",
"category": "Data",
"recipient": "08031234567",
"amount": 100,
"status": "delivered",
"paymentStatus": "paid",
"token": "4231 7718 0921 5530 1128",
"message": null,
"receiptUrl": "/api/v1/orders/IR7F3A9C21B0/receipt",
"addressProof": false,
"createdAt": "2026-11-15 14:09:31"
}
]
}401Missing or wrong API key.
{
"type": "unauthorized",
"message": "A valid API key is required"
}
