List Transactions Across Accounts

curl --request GET \
  --url https://api.rolla.xyz/api/v1/external/accounts/transactions

const options = {method: 'GET'};

fetch('https://api.rolla.xyz/api/v1/external/accounts/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rolla.xyz/api/v1/external/accounts/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rolla.xyz/api/v1/external/accounts/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.rolla.xyz/api/v1/external/accounts/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "data": {
    "transactions": [
      {
        "id": "<string>",
        "account_id": "<string>",
        "account_name": "<string>",
        "transaction_type": "<string>",
        "status": "<string>",
        "external_reference": "<string>",
        "source_amount": 123,
        "source_currency": "<string>",
        "destination_amount": 123,
        "destination_currency": "<string>",
        "fee_amount": 123,
        "fee_transaction_id": "<string>",
        "fee_reference": "<string>",
        "related_transaction_id": "<string>",
        "related_reference": "<string>",
        "created_at": "2023-11-07T05:31:56Z"
      }
    ],
    "hasMore": true,
    "totalCount": 123,
    "page": 123,
    "pageSize": 123,
    "totalPages": 123
  }
}

GET

accounts

transactions

List Transactions Across Accounts

curl --request GET \
  --url https://api.rolla.xyz/api/v1/external/accounts/transactions

const options = {method: 'GET'};

fetch('https://api.rolla.xyz/api/v1/external/accounts/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rolla.xyz/api/v1/external/accounts/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rolla.xyz/api/v1/external/accounts/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.rolla.xyz/api/v1/external/accounts/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "data": {
    "transactions": [
      {
        "id": "<string>",
        "account_id": "<string>",
        "account_name": "<string>",
        "transaction_type": "<string>",
        "status": "<string>",
        "external_reference": "<string>",
        "source_amount": 123,
        "source_currency": "<string>",
        "destination_amount": 123,
        "destination_currency": "<string>",
        "fee_amount": 123,
        "fee_transaction_id": "<string>",
        "fee_reference": "<string>",
        "related_transaction_id": "<string>",
        "related_reference": "<string>",
        "created_at": "2023-11-07T05:31:56Z"
      }
    ],
    "hasMore": true,
    "totalCount": 123,
    "page": 123,
    "pageSize": 123,
    "totalPages": 123
  }
}

Every transaction across all the accounts you manage — your own and each account you have onboarded — newest first, in one call. This is the endpoint to reconcile against. List Wallet Transactions returns one account at a time, so reconciling a book of accounts through it means one request per account and then working out yourself which rows came from where. Here, each row names the account it belongs to.

Available to partner API keys — a key that manages onboarded accounts. An ordinary key receives 403.

curl "https://api.rolla.xyz/api/v1/external/accounts/transactions?pageSize=100" \
  -H "X-API-Key: your_api_key_here"

{
  "success": true,
  "data": {
    "transactions": [
      {
        "id": "b0a1c2d3-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
        "account_id": "eec3cbed-79d8-4370-87a0-b6be9e287337",
        "account_name": "Beta Logistics LLC",
        "transaction_type": "withdrawal",
        "status": "completed",
        "external_reference": "NG-J46RHHKV",
        "source_amount": 50000,
        "source_currency": "NGN",
        "fee_amount": 250,
        "fee_transaction_id": "c1b2a3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
        "fee_reference": "FEE-8KD02M1X",
        "created_at": "2026-08-19T10:00:00.000Z"
      },
      {
        "id": "c1b2a3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
        "account_id": "9f1e2d3c-4b5a-4968-8877-665544332211",
        "account_name": "Your Company Ltd",
        "transaction_type": "fee",
        "status": "completed",
        "external_reference": "FEE-8KD02M1X",
        "related_transaction_id": "b0a1c2d3-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
        "related_reference": "NG-J46RHHKV",
        "source_amount": 250,
        "source_currency": "NGN",
        "created_at": "2026-08-19T10:00:01.000Z"
      }
    ],
    "totalCount": 4182,
    "page": 1,
    "pageSize": 100,
    "totalPages": 42,
    "hasMore": true
  }
}

What it includes

Everything that happened, so a reconciliation balances:

Failed movements. A payout that failed still debited and returned the money. The per-account endpoints leave these out of their default view — this one reports them, because a ledger that never sees the reversal cannot be balanced against ours.
Deposits still awaiting confirmation, reported with status: "pending". Funds have been detected but are not yet final, so treat them as expected rather than settled.

Pass status to narrow it yourself — status=completed for settled activity only.

Amounts

Amounts on this endpoint are in major units — 12.50 means $12.50 — and may carry decimals.

Webhook payloads report the same amount in minor units. One fee, two surfaces:

	`fee_amount`
this endpoint	`2`
`fee.charged` / `transaction.completed` webhook	`200`

Both are $2.00. If you join a webhook to a row here — following fee_transaction_id to its FEE-* row, for instance — convert before you compare, or the two will differ by a factor of 100.We intend to make this consistent. Changing it would silently alter every amount for integrations already reading this endpoint, so it will come as a versioned change with notice rather than in place.

Paging

page and pageSize, the same as every other transaction listing on this API. pageSize defaults to 20 and caps at 100.

curl "https://api.rolla.xyz/api/v1/external/accounts/transactions?page=2&pageSize=100" \
  -H "X-API-Key: your_api_key_here"

totalPages tells you how many pages to collect; hasMore is false on the last one.

Reconcile over a closed date range. Ask for a day that has finished — startDate=2026-08-19&endDate=2026-08-19 — and then page through it. Paging an open-ended list while transactions are still arriving means new rows land at the top and shift everything down, so a row can move past a page boundary between two calls and never be returned. A range that is already closed cannot take new rows, so the pages are stable while you read them.

Filtering

currency, transactionType, status, startDate, endDate and search all apply across every account, not just your own. A daily run typically filters by date:

curl "https://api.rolla.xyz/api/v1/external/accounts/transactions?startDate=2026-08-19&endDate=2026-08-19" \
  -H "X-API-Key: your_api_key_here"

To pull only the fees charged to you, filter on the type:

curl "https://api.rolla.xyz/api/v1/external/accounts/transactions?transactionType=fee" \
  -H "X-API-Key: your_api_key_here"

CSV

Add format=csv for the same rows as a file, for a finance team that works in a spreadsheet:

curl "https://api.rolla.xyz/api/v1/external/accounts/transactions?format=csv&startDate=2026-08-19" \
  -H "X-API-Key: your_api_key_here" -o transactions.csv

Paging comes back in the X-Total-Count and X-Total-Pages response headers, since a CSV body has nowhere to carry it.

Reconciling fees

When a fee is charged to your account rather than to the account that incurred it, it is a transaction on your account in its own right — transaction_type: "fee", reference FEE-XXXXXXXX — and it appears in this feed alongside the movement that caused it. The two are linked in both directions:

On	Field	Points to
the payout	`fee_transaction_id`, `fee_reference`	the fee row
the fee row	`related_transaction_id`, `related_reference`	the payout

So a fee never has to be matched by amount or timing. A fee appears here as soon as it is held, with status: "pending" — that is when your available balance moves, not when the fee posts. It reaches completed when the money is actually taken, or failed if the transaction that incurred it was unwound and the hold released. To be told at each of those points rather than discovering them on the next run, subscribe to fee.pending, fee.charged and fee.released.

transaction_id is the stable identifier. external_reference is yours to recognise a transaction by, but id is what we guarantee for the life of the transaction — key your records on it.

Query Parameters

page

integer

default:1

Page number, starting at 1.

Required range: x >= 1

pageSize

integer

default:20

Rows per page. Caps at 100, matching the per-account listing.

Required range: 1 <= x <= 100

currency

string

Filter by source currency, e.g. USD.

transactionType

enum<string>

Filter by type. Use fee to list only fees charged to you.

Available options:

deposit,

withdrawal,

fx_withdrawal,

swap,

transfer,

fee

status

string

Filter by status, e.g. completed.

startDate

string

Inclusive start, YYYY-MM-DD or ISO-8601.

endDate

string

Inclusive end, YYYY-MM-DD or ISO-8601.

string

Match on external reference.

format

enum<string>

csv returns the same rows as a file; paging comes back in the X-Total-Count and X-Total-Pages headers.

Available options:

json,

csv

Response

A page of transactions

success

boolean

message

string

data

object

Show child attributes

Overview

Banks

Account Lookup

Transactions

Wallet

Beneficiaries

Teams

Account Onboarding

Webhooks

List Transactions Across Accounts

What it includes

Amounts

Paging

Filtering

CSV

Reconciling fees

Query Parameters

Response

​What it includes

​Amounts

​Paging

​Filtering

​CSV

​Reconciling fees

Query Parameters

Response

What it includes

Amounts

Paging

Filtering

CSV

Reconciling fees