List statement lines

GET

/statements/{date}/lines

const url = 'https://api.poweredbyaura.com/v1/statements/2026-10-12/lines?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/statements/2026-10-12/lines?limit=25' \
  --header 'Authorization: Bearer <token>'

Returns every balance movement on the statement: purchases charged, reversals refunded, funding and adjustments. Ask for text/csv in the Accept header to download the whole day as one CSV file instead.

Authorizations

apiKey

Parameters

Path Parameters

date

required

string format: date

The UTC day, as YYYY-MM-DD.

Example

2026-10-12

Query Parameters

limit

integer

default: 25 >= 1 <= 100

Items per page, from 1 to 100.

cursor

string

The next_cursor from the previous page.

Responses

200

A page of statement lines, or the whole day as CSV.

object

object

required

string

Allowed value: list

data

required

Array<object>

object

required

string

object

required

string

Allowed value: statement_line

type

required

purchase: a successful purchase was charged. reversal: a reversed purchase was refunded. funding: you topped up. adjustment: a correction agreed with you.

string

Allowed values: purchase reversal funding adjustment

occurred_at

required

string format: date-time

amount

required

Signed amount in minor units.

integer

currency

required

string

balance_after

required

integer

purchase_id

required

string | null

reference

required

string | null

phone_number

required

string | null

bundle_id

required

string | null

has_more

required

boolean

next_cursor

required

string | null

Examples

lines

The first lines of a day

{
  "object": "list",
  "data": [
    {
      "id": "stl_01JA80C1",
      "object": "statement_line",
      "type": "purchase",
      "occurred_at": "2026-10-12T09:14:31Z",
      "amount": -35000,
      "currency": "NGN",
      "balance_after": 12465000,
      "purchase_id": "pur_01JA7ZK3Q9W2D8M5X4N6B1C0VE",
      "reference": "order-10293",
      "phone_number": "+2348000000001",
      "bundle_id": "bnd_ng_a_1gb_1d"
    },
    {
      "id": "stl_01JA80D7",
      "object": "statement_line",
      "type": "reversal",
      "occurred_at": "2026-10-12T11:02:40Z",
      "amount": 35000,
      "currency": "NGN",
      "balance_after": 12395000,
      "purchase_id": "pur_01JA7ZT2N8D5K1Q7W3F9C6M4BR",
      "reference": "order-10295",
      "phone_number": "+2348000000005",
      "bundle_id": "bnd_ng_a_1gb_1d"
    }
  ],
  "has_more": true,
  "next_cursor": "c_stl_01JA80D7"
}

string

Example

line_id,type,occurred_at,purchase_id,reference,phone_number,bundle_id,amount,currency,balance_after
stl_01JA80C1,purchase,2026-10-12T09:14:31Z,pur_01JA7ZK3Q9W2D8M5X4N6B1C0VE,order-10293,+2348000000001,bnd_ng_a_1gb_1d,-35000,NGN,12465000

Headers

Aura-Request-Id

string

Example

req_7Kp2Vx9QmR4t

A unique ID for this request. Quote it when you contact your technical contact.

401

The API key is missing, wrong or revoked.

application/json

object

error

required

object

code

required

A stable, machine-readable code. New codes may be added in v1, so treat an unknown code by its HTTP status and retryable flag.

string

Allowed values: invalid_request invalid_phone_number invalid_api_key ip_not_allowed not_found insufficient_balance reference_conflict bundle_unavailable network_mismatch unsupported_network rate_limited internal_error network_unavailable

message

required

A human-readable explanation. Do not parse it; use code.

string

param

The request field the error is about, when there is one.

string

retryable

required

Whether the same request can succeed if you retry it later.

boolean

request_id

required

string

details

Extra facts about the error, such as the existing purchase or the network’s status.

object

key

additional properties

any

Examples

invalidKey

{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key is not valid.",
    "retryable": false,
    "request_id": "req_2Mz6Rt8KcW1p"
  }
}

Headers

Aura-Request-Id

string

Example

req_7Kp2Vx9QmR4t

A unique ID for this request. Quote it when you contact your technical contact.

404

No such resource on your account.

application/json

object

error

required

object

code

required

A stable, machine-readable code. New codes may be added in v1, so treat an unknown code by its HTTP status and retryable flag.

string

message

required

A human-readable explanation. Do not parse it; use code.

string

param

The request field the error is about, when there is one.

string

retryable

required

Whether the same request can succeed if you retry it later.

boolean

request_id

required

string

details

Extra facts about the error, such as the existing purchase or the network’s status.

object

key

additional properties

any

Examples

notFound

{
  "error": {
    "code": "not_found",
    "message": "No purchase pur_01JA7ZK3Q9W2D8M5X4N6B1C0VX on this account.",
    "retryable": false,
    "request_id": "req_8Wc3Ld5YhF2k"
  }
}

Headers

Aura-Request-Id

string

Example

req_7Kp2Vx9QmR4t

A unique ID for this request. Quote it when you contact your technical contact.