List actions
const url = 'https://api.poweredbyaura.com/v1/actions?reference=dep-889431&campaign_id=cmp_01JA9TQ4W2D8M5X4N6B1C0VEKA&customer_id=CUS-204871&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/actions?reference=dep-889431&campaign_id=cmp_01JA9TQ4W2D8M5X4N6B1C0VEKA&customer_id=CUS-204871&limit=25' \ --header 'Authorization: Bearer <token>'Returns the actions you reported, newest first. Filter by reference to find one action by your own ID.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Your reference for the action. Returns at most one action.
Example
dep-889431Example
cmp_01JA9TQ4W2D8M5X4N6B1C0VEKAExample
CUS-204871Only actions received at or after this time.
Only actions received before this time.
Items per page, from 1 to 100.
The next_cursor from the previous page.
Responses
Section titled “Responses”A page of actions.
object
object
object
object
Amount in the currency’s minor unit (kobo for NGN).
ISO 4217 currency code.
object
The customer’s group, set at random the first time you report them. Don’t show the plan to customers in
the comparison group, but keep sending their actions.
Whether the action earned data under the plan’s rules. It can change once, from true to false, when a
flagged reward is rejected in review or the customer doesn’t accept the plan in time.
Why an action earned no data. New reasons may be added in v1.
comparison_group: the customer is in the comparison group; the action is recorded and nothing is paid.
already_rewarded: this period’s reward was already earned. number_already_rewarded: another customer ID
on this phone number already earned this reward this period. condition_not_met: the action carried less
than the plan’s condition. not_eligible: the plan is only for customers first reported after it started.
no_plan: a keep action for a customer whose plan hasn’t started. plan_cancelled: the plan cancelled
after a missed period. plan_ended: the customer has held the plan for its full length. too_late: the
action arrived after its period closed; it still counts in results. customer_limit_reached and
daily_limit_reached: a campaign limit was reached. budget_reached: the campaign’s budget is spent.
campaign_paused and campaign_ended: the campaign isn’t live. referral_not_allowed: a self-referral, a
friend on the customer’s own number, or a friend who was already a customer. friend_limit_reached: the
customer has brought the most friends the plan allows. rejected_in_review: a flagged reward was rejected
in review. customer_not_accepted: the customer didn’t accept the plan before the period ended.
The rewards this action earned. A referral earns one for the customer and one for the friend.
object
Who receives it. For a referral, one reward is the customer’s and one is the friend’s.
plan_delivery: a period’s data. first_action: a one-off reward for starting the plan. referral: a referral reward.
An amount of mobile data in gigabytes (GB), as set in the plan, to at most two decimal places.
waiting_for_customer: earned, waiting for the customer to accept the plan. flagged: waiting for review.
waiting_for_balance: your balance doesn’t cover it; it waits up to 24 hours for a top-up, then fails.
pending: its price is held and the delivery is on its way. delivered: the network confirmed it and your
balance was charged. failed: not delivered, nothing charged. reversed: the network reversed a delivery
and you were refunded. rejected: rejected in review, or lapsed because the customer didn’t accept the plan.
object
not_offered: the customer is in the comparison group. offered: the plan was offered, after its start
action or by an offer, and waits for the customer to accept. active: accepted, and this period is kept or
still open. at_risk: the warning has gone
out and this period’s action isn’t in yet. cancelled: a period ended without its action. ended: the
customer held the plan for its full length, or the campaign ended.
object
true when sent with a test key.
object
Example
{ "object": "list", "data": [ { "object": "action", "group": "offer", "reason": "comparison_group", "rewards": [ { "object": "reward", "kind": "plan_delivery", "status": "waiting_for_customer" } ], "plan": { "object": "plan", "status": "not_offered" } } ]}Headers
Section titled “Headers”Example
req_7Kp2Vx9QmR4tA unique ID for this request. Quote it when you contact Aura.
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. The first block is shared with the Data Reselling API.
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 action.
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 Aura.
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. The first block is shared with the Data Reselling API.
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 action.
object
Examples
{ "error": { "code": "invalid_api_key", "message": "The API key is missing, wrong or revoked.", "retryable": false, "request_id": "req_4Lm8Tc2VqZ7k" }}Headers
Section titled “Headers”Example
req_7Kp2Vx9QmR4tA unique ID for this request. Quote it when you contact Aura.
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. The first block is shared with the Data Reselling API.
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 action.
object
Examples
{ "error": { "code": "rate_limited", "message": "Too many requests. Retry after 2 seconds.", "retryable": true, "request_id": "req_2Vb7Nx4KtJ9q" }}Headers
Section titled “Headers”Example
req_7Kp2Vx9QmR4tA unique ID for this request. Quote it when you contact Aura.
Requests allowed in the current window.
Requests left in the current window.
Seconds until the current window resets.
Seconds to wait before retrying.
© 2026 PressOne Africa Limited ·poweredbyaura.com ·Privacy ·Terms