# List Transactions

API to fetch transactions across collection links or channels using account-based routing.

Endpoint: GET /v1/collections/transactions
Version: 1.0.0
Security: Bearer

## Query parameters:

  - `id` (string)
    Filter transactions by specific transaction ID

  - `status` (string)
    Transaction status
    Enum: "COMPLETED", "FAILED_KYT", "FAILED", "HOLD_KYT", "REFUNDED_KYT", "PROCESSING", "IGNORED"

  - `payer_id` (string)
    Filter transactions by payer identifier

  - `beneficiary_id` (string)
    Filter transactions by beneficiary identifier

  - `account_id` (string)
    Filter transactions by account identifier

  - `currency` (string)
    Filter transactions by transaction currency

  - `network` (string)
    Filter transactions by transaction network
    Enum: "ETHEREUM", "ETHEREUM_SEPOLIA_TESTNET", "SOLANA", "SOLANA_TESTNET", "XRPL", "XRPL_TESTNET"

  - `wallet_address` (string)
    Filter transactions by wallet address

  - `since` (string)
    ISO 8601 timestamp after transaction was created

  - `until` (string)
    ISO 8601 timestamp before transaction was created

  - `page` (integer)
    Page number (zero-indexed, starts at 0)

  - `size` (integer)
    Page size (items per page)
    Example: 10

  - `sort_by` (string)
    Field to sort results by
    Enum: "TRANSACTION_DATE", "CREATED_AT", "STATUS"

  - `direction` (string)
    Sort direction
    Enum: "asc", "desc"

## Response 200 fields (application/json):

  - `content` (array)

  - `content.id` (string, required)
    Unique identifier for the transaction
    Example: "487ba009-56cf-4ad9-8b5c-045e27893e00"

  - `content.parent_id` (string, required)
    Identifier of the parent entity (collection link or channel) for this transaction
    Example: "e8d43598-107d-4694-9fb2-934e7484c3d4"

  - `content.account_id` (string, required)
    Identifier of the account associated with this transaction
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `content.settlement_id` (string,null)
    Identifier of the settlement this transaction was included in, if any
    Example: "63dd59dd-88be-41a2-a246-2f6724209422"

  - `content.payer` (object, required)
    Payer partner details

  - `content.payer.id` (string, required)
    Unique identifier for the payer partner
    Example: "0c5479ff-3772-4123-b2b7-e679e71eb570"

  - `content.payer.name` (string, required)
    Full name of the payer partner
    Example: "Nigerian Imports Ltd."

  - `content.payer.email` (string, required)
    Email address of the payer partner
    Example: "nigerian@imports.com"

  - `content.beneficiary` (object, required)
    Beneficiary partner details

  - `content.beneficiary.id` (string, required)
    Unique identifier of the beneficiary partner
    Example: "01467076-8bb0-41c1-ad54-5751dd4a9e80"

  - `content.beneficiary.name` (string, required)
    Full name of the beneficiary partner
    Example: "Hong Kong Exports Ltd."

  - `content.beneficiary.email` (string, required)
    Email address of the beneficiary partner
    Example: "hongkong@exports.com"

  - `content.payment_amount` (object, required)
    Payment amount and asset

  - `content.payment_amount.value` (string, required)
    Payment amount as a string to preserve precision
    Example: "50.00000000"

  - `content.payment_amount.asset` (string, required)
    Asset symbol of the payment
    Example: "USDT"

  - `content.account_equivalent` (object, required)
    Account equivalent amounts for payment, fee, and net (converted to account's native currency)

  - `content.account_equivalent.gross_amount` (object, required)

  - `content.account_equivalent.gross_amount.value` (string, required)
    Gross amount in account currency
    Example: "50.00"

  - `content.account_equivalent.gross_amount.currency` (string, required)
    Account currency code
    Example: "USD"

  - `content.account_equivalent.fee_amount` (object, required)

  - `content.account_equivalent.fee_amount.value` (string, required)
    Fee amount in account currency
    Example: "0.50"

  - `content.account_equivalent.fee_amount.currency` (string, required)
    Account currency code
    Example: "USD"

  - `content.account_equivalent.net_amount` (object, required)

  - `content.account_equivalent.net_amount.value` (string, required)
    Net amount in account currency
    Example: "49.50"

  - `content.account_equivalent.net_amount.currency` (string, required)
    Account currency code
    Example: "USD"

  - `content.market_rate` (object, required)
    Market rate reference for the transaction

  - `content.market_rate.base` (string)
    Base currency for the exchange rate
    Example: "USDT"

  - `content.market_rate.counter` (string)
    Counter currency for the exchange rate
    Example: "USD"

  - `content.market_rate.rate` (string)
    Exchange rate from base to counter currency
    Example: "1.00"

  - `content.exchange_rate` (object, required)
    Exchange rate applied on the transaction

  - `content.exchange_rate.base` (string)
    Base currency for the exchange rate
    Example: "USDT"

  - `content.exchange_rate.counter` (string)
    Counter currency for the exchange rate
    Example: "USD"

  - `content.exchange_rate.rate` (string)
    Exchange rate from base to counter currency
    Example: "0.99"

  - `content.source_payment_method` (object, required)
    Source payment method details for a transaction

  - `content.status` (string, required)
    Transaction status
    Enum: "COMPLETED", "FAILED_KYT", "FAILED", "HOLD_KYT", "REFUNDED_KYT", "PROCESSING", "IGNORED"

  - `content.reason` (string,null)
    Reason for current status (if applicable)

  - `content.transaction_processed_date` (string, required)
    ISO 8601 timestamp of the transaction
    Example: "2025-06-17T12:20:00Z"

  - `content.date_created` (string, required)
    ISO 8601 timestamp when transaction was created
    Example: "2025-09-18T22:54:00.542Z"

  - `content.date_confirmed` (string, required)
    ISO 8601 timestamp when transaction was confirmed
    Example: "2025-09-18T22:54:00.542Z"

  - `page` (object)
    Pagination metadata.

  - `page.page` (integer, required)

  - `page.size` (integer, required)
    Example: 10

  - `page.total_elements` (integer, required)
    Example: 100

  - `page.total_pages` (integer, required)
    Example: 10

## Response 400 fields (application/json):

  - `code` (string, required)
    Error code identifying the type of error

  - `reason` (string, required)
    Human-readable error message