List transactions

GET

/accounts/{id}/transactions

const url = 'https://api.banklink.co.za/v1/accounts/3fa85f64-5717-4562-b3fc-2c963f66afa6/transactions?limit=100';
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.banklink.co.za/v1/accounts/3fa85f64-5717-4562-b3fc-2c963f66afa6/transactions?limit=100' \
  --header 'Authorization: Bearer <token>'

Returns cursor-paginated transactions for the specified account, ordered by date descending. Maximum 500 per page (default 100).

Authorizations

bearerAuth

Parameters

Path Parameters

required

string format: uuid

UUID of the bank account (bank profile)

Example

3fa85f64-5717-4562-b3fc-2c963f66afa6

Query Parameters

limit

integer

default: 100 >= 1 <= 500

Number of transactions to return (1–500, default 100)

cursor

string

Opaque pagination cursor returned by a previous response

Responses

200

Paginated transaction list

application/json

object

data

required

Array<object>

object

required

Internal unique identifier

string format: uuid

account_id

required

ID of the parent bank account (bank_profile_id)

string format: uuid

external_id

required

Unique transaction identifier from the bank

string

date

required

Transaction date (YYYY-MM-DD)

string format: date

description

required

Transaction description as reported by the bank

string

amount

required

Absolute transaction amount (always positive)

number

currency

required

ISO 4217 currency code

string

direction

required

Whether money left (debit) or entered (credit) the account

string

Allowed values: debit credit

balance

required

Running balance after this transaction. Null if not provided by the bank.

number | null

reference

required

Optional payment reference

string | null

created_at

required

ISO 8601 timestamp when the transaction was ingested

string format: date-time

cursor

required

Pass this value as cursor in the next request to fetch the following page. Null when there are no more pages.

string | null

Example

{
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "account_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "external_id": "TXN20260608001",
      "date": "2026-06-08",
      "description": "POS PURCHASE - WOOLWORTHS",
      "amount": 349.99,
      "currency": "ZAR",
      "direction": "debit",
      "balance": 12500,
      "reference": "INV-2026-0042",
      "created_at": "2026-06-08T10:00:00.000Z"
    }
  ]
}

400

Invalid cursor

application/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

Human-readable error description

string

Example

{
  "error": {
    "code": "not_found",
    "message": "Account not found"
  }
}

401

Missing or invalid API key

application/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

Human-readable error description

string

Example

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

404

Resource not found

application/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

Human-readable error description

string

Example

{
  "error": {
    "code": "not_found",
    "message": "Account not found"
  }
}