List purchases
const url = 'https://api.poweredbyaura.com/v1/purchases?reference=order-10293&status=pending&phone_number=%2B2348000000001&limit=25';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.poweredbyaura.com/v1/purchases?reference=order-10293&status=pending&phone_number=%2B2348000000001&limit=25' \ --header 'Authorization: Bearer <token>'Returns your purchases, newest first. Filter by reference to find one purchase by your own ID, or by a
time range to reconcile a period.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Your reference for the purchase. Returns at most one purchase.
Example
order-10293pending: accepted, waiting for the network’s confirmation. successful: the network confirmed the
bundle was credited, and you were charged. failed: the bundle was not credited, and you were not
charged. reversed: the network reversed a successful bundle, and you were refunded. successful,
failed and reversed are final, except that successful can become reversed.
Example
+2348000000001Only purchases created at or after this time.
Only purchases created before this time.
Items per page, from 1 to 100.
The next_cursor from the previous page.
Responses
Section titled “Responses”A page of purchases.
object
object
pending: accepted, waiting for the network’s confirmation. successful: the network confirmed the
bundle was credited, and you were charged. failed: the bundle was not credited, and you were not
charged. reversed: the network reversed a successful bundle, and you were refunded. successful,
failed and reversed are final, except that successful can become reversed.
The bundle as it was when bought.
object
The amount held while pending, charged if successful, and refunded if reversed.
object
Amount in the currency’s minor unit (kobo for NGN).
ISO 4217 currency code.
The latest time by which this purchase will reach a final state. If the network has not confirmed by
then, the purchase fails with network_timeout and nothing is charged.
When the purchase reached successful or failed.
Present once the network has confirmed the bundle was credited.
object
The network’s own reference for the credit, when the network provides one.
Present when the purchase failed.
object
Why a purchase failed. New codes may be added in v1.
Present when a successful purchase was reversed.
object
object
Examples
One purchase found by reference
{ "object": "list", "data": [ { "id": "pur_01JA7ZK3Q9W2D8M5X4N6B1C0VE", "object": "purchase", "reference": "order-10293", "status": "successful", "phone_number": "+2348000000001", "network_id": "net_ng_a", "bundle": { "id": "bnd_ng_a_1gb_1d", "name": "1GB Daily", "data_mb": 1024, "validity_hours": 24 }, "price": { "amount": 35000, "currency": "NGN" }, "created_at": "2026-10-12T09:14:30Z", "resolve_by": "2026-10-12T09:44:30Z", "completed_at": "2026-10-12T09:14:31Z", "delivery": { "confirmed_at": "2026-10-12T09:14:31Z", "network_reference": "A-8841207731" }, "failure": null, "reversal": null, "metadata": { "customer_id": "cus_88412" } } ], "has_more": false, "next_cursor": null}Headers
Section titled “Headers”Example
req_7Kp2Vx9QmR4tA unique ID for this request. Quote it when you contact your technical contact.
The request is malformed or a field is invalid. Fix it before retrying.
object
object
A stable, machine-readable code. New codes may be added in v1, so treat an unknown code by its HTTP
status and retryable flag.
A human-readable explanation. Do not parse it; use code.
The request field the error is about, when there is one.
Whether the same request can succeed if you retry it later.
Extra facts about the error, such as the existing purchase or the network’s status.
object
Examples
{ "error": { "code": "invalid_phone_number", "message": "phone_number must be in E.164 format, such as +2348000000001.", "param": "phone_number", "retryable": false, "request_id": "req_9Qd4Hs1XvB7n" }}Headers
Section titled “Headers”Example
req_7Kp2Vx9QmR4tA unique ID for this request. Quote it when you contact your technical contact.
The API key is missing, wrong or revoked.
object
object
A stable, machine-readable code. New codes may be added in v1, so treat an unknown code by its HTTP
status and retryable flag.
A human-readable explanation. Do not parse it; use code.
The request field the error is about, when there is one.
Whether the same request can succeed if you retry it later.
Extra facts about the error, such as the existing purchase or the network’s status.
object
Examples
{ "error": { "code": "invalid_api_key", "message": "The API key is not valid.", "retryable": false, "request_id": "req_2Mz6Rt8KcW1p" }}Headers
Section titled “Headers”Example
req_7Kp2Vx9QmR4tA unique ID for this request. Quote it when you contact your technical contact.
Too many requests. Wait for Retry-After seconds, then retry.
object
object
A stable, machine-readable code. New codes may be added in v1, so treat an unknown code by its HTTP
status and retryable flag.
A human-readable explanation. Do not parse it; use code.
The request field the error is about, when there is one.
Whether the same request can succeed if you retry it later.
Extra facts about the error, such as the existing purchase or the network’s status.
object
Examples
{ "error": { "code": "rate_limited", "message": "Too many requests. Retry after 2 seconds.", "retryable": true, "request_id": "req_6Yf2Pk8GwN4s" }}Headers
Section titled “Headers”Example
req_7Kp2Vx9QmR4tA unique ID for this request. Quote it when you contact your technical contact.
Seconds to wait before retrying.
Requests allowed in the current window.
Requests left in the current window.
Seconds until the current window resets.
© 2026 Aura Mobile Communications Ltd ·poweredbyaura.com ·Privacy ·Terms