Transactions

Transactions enable the bulk retrieval of transaction data for reconciliation and reporting purposes.

Endpoints

GET /transactions Retrieve transactions GET /transactions/{id} Retrieve transaction

GET /transactions

Retrieve a list of transactions across all accounts with optional filtering.

Query Parameters

Parameter	Type	Description
`account_id`	string	Filter by account ID
`customer_id`	string	Filter by customer ID
`type`	string	Filter by transaction type
`from_date`	string	Start date (ISO 8601)
`to_date`	string	End date (ISO 8601)
`limit`	integer	Number of results (default: 50, max: 1000)
`cursor`	string	Pagination cursor

Response

200 OK

{
  "data": [
    {
      "id": "txn_111222333",
      "account_id": "acc_123456789",
      "customer_id": "cust_987654321",
      "type": "DEPOSIT",
      "amount": "5000.00",
      "currency": "USD",
      "balance_after": "15000.00",
      "status": "COMPLETED",
      "description": "Wire transfer deposit",
      "reference": "PAY999888777",
      "created_at": "2026-01-15T10:30:00Z"
    },
    {
      "id": "txn_444555666",
      "account_id": "acc_123456789",
      "customer_id": "cust_987654321",
      "type": "WITHDRAWAL",
      "amount": "-2500.00",
      "currency": "USD",
      "balance_after": "12500.00",
      "status": "COMPLETED",
      "description": "ACH withdrawal",
      "reference": "WTH777666555",
      "created_at": "2026-01-14T09:15:00Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "cursor_xyz789"
  }
}

GET /transactions/{id}

Retrieve details of a specific transaction.

Path Parameters

Parameter	Type	Description
`id` required	string	The transaction ID

Response

200 OK

{
  "id": "txn_111222333",
  "account_id": "acc_123456789",
  "customer_id": "cust_987654321",
  "type": "DEPOSIT",
  "amount": "5000.00",
  "currency": "USD",
  "balance_before": "10000.00",
  "balance_after": "15000.00",
  "status": "COMPLETED",
  "description": "Wire transfer deposit",
  "reference": "PAY999888777",
  "related_entity": {
    "type": "PAYMENT",
    "id": "pay_999888777"
  },
  "counterparty": {
    "id": "cpty_111222333",
    "name": "John Doe - Chase"
  },
  "metadata": {
    "sender_name": "John Doe",
    "sender_reference": "INV-2026-001"
  },
  "created_at": "2026-01-15T10:30:00Z",
  "completed_at": "2026-01-15T10:35:00Z"
}

Transaction Types

Type	Description
`DEPOSIT`	Funds deposited into account
`WITHDRAWAL`	Funds withdrawn from account
`TRANSFER_IN`	Funds received via internal transfer
`TRANSFER_OUT`	Funds sent via internal transfer
`EXCHANGE_IN`	Funds received from exchange
`EXCHANGE_OUT`	Funds sent to exchange
`FEE`	Fee charged
`MARKET_ADJUSTMENT`	Slippage refund from exchange
`REVERSAL`	Transaction reversal

Transaction Status Values

Status	Description
`PENDING`	Transaction initiated, not yet completed
`COMPLETED`	Transaction completed successfully
`FAILED`	Transaction failed
`REVERSED`	Transaction was reversed