Get a purchase
GET
https://instantrecharge.com.ng/api/v1/transactions/{reference}Finds a purchase by the Idempotency-Key you sent. If the order is still in progress we check with the provider before answering, so polling this endpoint moves pending orders along.
Requires your API key.
Headers
| Name | Type | Description |
|---|---|---|
Authorizationrequired | string | Bearer followed by your API key. |
Path parameters
| Name | Type | Description |
|---|---|---|
referencerequired | string | The Idempotency-Key you sent. |
Responses
200The purchase.
{
"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"
}404No purchase of yours has that reference.
{
"type": "not_found",
"message": "No purchase with that reference"
}
