Transactions

Status: Available (read). You can list transactions and read one transaction. The list fills as you collect and pay out. Before that, your list is empty.

A transaction is one money movement — a collection or a payout. Both share the same object and the same progress timeline.

List transactions

GET /v1/transactions?page=1

Returns your transactions, newest first, paginated.

Query param	Description
`page`	1-based page number.
`type`	Filter: `deposit` (collection) or `withdrawal` (payout).
`status`	Filter by status.

Get a transaction

GET /v1/transactions/{id}

{
  "code": 200,
  "message": "Transaction retrieved",
  "data": {
    "id": "txn_…",
    "type": "withdrawal",
    "status": "processing",
    "amount": 100.50,
    "currency": "USD",
    "fee": 0.50,
    "reference": "payroll_jun_8842",
    "created_at": "2026-06-25T10:16:57.000Z",
    "timeline": [
      { "stage": "requested",  "message": "We received your request",          "status": "completed",   "occurred_at": "2026-06-25T10:16:57.000Z" },
      { "stage": "debited",    "message": "Funds debited from your balance",    "status": "completed",   "occurred_at": "2026-06-25T10:16:57.000Z" },
      { "stage": "processing", "message": "Converting and routing your funds",  "status": "in_progress", "occurred_at": "2026-06-25T10:17:00.000Z" }
    ]
  }
}

Amounts (amount, fee) are in USD. Render timeline as a progress stepper — see transaction lifecycle.

Use webhooks and do not read this endpoint again and again. When a transaction gets a final status, we send you a signed event. The events are collection.*, payout.*, virtual_account.deposit.*, and orchestration.*.

Orchestrate

Customers