wallet

List wallet ledger entries

Read the append-only wallet transaction history, newest first, with cursor pagination.

Page with ?limit= (max 200, default 50) and ?cursor= (the previous page's next_cursor, a created_at timestamp).

direction is credit (top-ups) or debit (sends); amount_zar_cents is always positive and balance_after_zar_cents is the running balance after the entry.

message_id is set on per-send debits and topup_id on credits; the ledger is append-only and never edited.

get/api/v1/wallet/ledger

Request

  • Base URL: https://app.blueticked.com
  • URL: https://app.blueticked.com/api/v1/wallet/ledger
  • Auth: HTTP bearer

Query parameters

limitinteger

Maximum number of items to return.

cursorstring

Opaque pagination cursor. Pass the next_cursor from a previous response; do not construct it yourself.

Response

Success

next_cursorstring nullable required
has_moreboolean required
request_idstring required

Example response

{
  "data": [
    {
      "id": "842e48d4-26ce-44d7-a76f-fa860924c61a",
      "amount_zar_cents": 18,
      "balance_after_zar_cents": 19982,
      "reason": "message_send",
      "message_id": "763c4dc3-d46b-4c10-8bd4-3f233a933ea0",
      "created_at": "2026-07-01T08:00:00.000Z"
    }
  ],
  "request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}

Changes

No recorded changes to this operation across all 1 revision of this API.