# List transactions for an account

Retrieves a paginated list of transactions associated with a specific account. Replaces the embedded transactions array in channel/collection responses for better scalability and pagination support.

Endpoint: GET /v1/collections/accounts/{account_id}/transactions
Version: 1.0.0
Security: Bearer

## Security:

  - `Bearer` (unknown)
    http bearer JWT

## Path parameters:

  - `account_id` (string, required)
    Unique identifier of the account

## Query parameters:

  - `status` (string)
    Filter by transaction status

  - `since` (string)
    ISO 8601 timestamp — return transactions created after this time

  - `until` (string)
    ISO 8601 timestamp — return transactions created before this time

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

  - `size` (integer)
    Page size (items per page)

## Response 200:

  - `200` (unknown)
    A paginated list of transactions for the account.

## Response 200 fields (application/json):

  - `data` (array)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `data.source_payment_method.type` (string, required)
    Discriminator: indicates blockchain payment method
    Enum: "BLOCKCHAIN"

  - `data.source_payment_method.network` (string, required)
    Supported blockchain networks
    Enum: "ETHEREUM", "ETHEREUM_SEPOLIA_TESTNET", "SOLANA", "SOLANA_TESTNET", "XRPL", "XRPL_TESTNET"

  - `data.source_payment_method.transaction_hash` (string, required)
    Blockchain transaction hash
    Example: 0x94365ftfr76iy45t6ghu876567ytr54ertyui987uyt698uyh87u

  - `data.source_payment_method.block_id` (string, required)
    Blockchain block identifier containing this transaction
    Example: 0xh7865gugi87yea94e8267987a9e91eddcd0da916b22f3cfa0c8bd91dbad85

  - `data.source_payment_method.source_address` (string, required)
    Blockchain address from which funds were sent
    Example: 0x880f622a1933ACf82bFC5e630c9ab7f18eF47809

  - `data.source_payment_method.destination_address` (string, required)
    Blockchain address to which funds were sent
    Example: 0x02937b288b588058533C48b18EdFDdd76A324D6

  - `data.source_payment_method.gas_fee` (object, required)
    Blockchain gas fee details

  - `data.source_payment_method.gas_fee.value` (string)
    Gas fee value
    Example: 0.0045

  - `data.source_payment_method.gas_fee.asset` (string)
    Asset used to pay gas fee
    Example: ETH

  - `data.source_payment_method.type` (string, required)
    Discriminator: indicates Fedwire payment method
    Enum: "FEDWIRE"

  - `data.source_payment_method.account_number` (string, required)
    Source bank account number
    Example: XXXX7890

  - `data.source_payment_method.routing_number` (string, required)
    ABA routing number
    Example: 021000021

  - `data.source_payment_method.swift_code` (string)
    SWIFT/BIC code for international transfers
    Example: CHASUS33

  - `data.source_payment_method.memo` (string)
    Reference memo included with the transfer
    Example: Payment for invoice INV-2024-001

  - `data.source_payment_method.type` (string, required)
    Discriminator: indicates ACH payment method
    Enum: "ACH"

  - `data.source_payment_method.swift_code` (string)
    SWIFT/BIC code (optional for ACH)
    Example: CHASUS33

  - `data.source_payment_method.type` (string, required)
    Discriminator: indicates RTP payment method
    Enum: "RTP"

  - `data.source_payment_method.swift_code` (string)
    SWIFT/BIC code (optional for RTP)
    Example: CHASUS33

  - `data.source_payment_method.type` (string, required)
    Discriminator: indicates PIX payment method
    Enum: "PIX"

  - `data.source_payment_method.pix_key` (string, required)
    PIX key used for the payment
    Example: 12345678901

  - `data.source_payment_method.pix_key_type` (string, required)
    Type of PIX key
    Enum: "CPF", "CNPJ", "EMAIL", "PHONE", "RANDOM"

  - `data.source_payment_method.sender_name` (string)
    Name of the sender as registered with PIX
    Example: João Silva

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

  - `data.reason` (string)
    Reason for current status (if applicable)
    Example: null

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

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

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

  - `page` (object)

  - `page.page` (integer)

  - `page.size` (integer)

  - `page.total_elements` (integer)

  - `page.total_pages` (integer)

## Response 400:

  - `400` (unknown)
    Bad Request - Invalid input parameters

## Response 400 fields (application/json):

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

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

## Response 401:

  - `401` (unknown)
    Unauthorized - Invalid or missing authentication

## Response 401 fields (application/json):

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

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

## Response 404:

  - `404` (unknown)
    Account not found

## Response 404 fields (application/json):

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

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

## Response 500:

  - `500` (unknown)
    Internal server error

## Response 500 fields (application/json):

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

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