crate::transaction::history::controller::openapi::transactions

GET /v1/customers/{customer_id}/transactions

Changed on

Request

Path parameters

customer_idstring required

Customer ID

Query parameters

transaction_action'DEPOSIT' | 'WITHDRAWAL' | 'CONVERSION' | 'AUTO_CONVERSION' | 'TRANSFER' | 'REWARD'

Filter by transaction action

transaction_idstring

Public transaction ID exposed by OpenAPI. Internally this maps to order IDs from the concrete transaction tables.

Example:aac5201f-7f1c-11f0-b018-de09fc637374
assetstring
  • Stablecoin assets: USDC, USDT, PYUSD, RLUSD, USDG, USDP, EURC, MXNB, 1USD(1USD/USDC conversion only, deposit/withdrawal not supported)
  • Digital assets: BTC, ETH, SOL
  • Fiat currencies: USD, MXN
Example:USDC
created_afterstring
Example:2025-08-21T07:56:57.981Z

Start time for transaction creation time range filter (RFC3339/ISO 8601 format)

created_beforestring
Example:2025-08-21T07:56:57.981Z

End time for transaction creation time range filter (RFC3339/ISO 8601 format)

include_subaccountsboolean

Include transactions from all sub-accounts under the same enterprise (default: false)

pageinteger

Page number (starts from 1, default: 1)

sizeinteger

Number of items per page (1-100, default: 10)

{
  "page": 1,
  "size": 10
}

Response

Successfully retrieved transaction list

totalinteger nullable

Example response

{
  "list": [
    {
      "customer_id": "14f20ebd-893b-11f0-b308-2eaa4f6974f2",
      "account_id": "BZ-A2C4-9XPN",
      "recipient_id": "f77a8df1-a2b3-4c5d-9e8f-1234567890ab",
      "transaction_id": "aac5201f-7f1c-11f0-b018-de09fc637374",
      "amount": "500",
      "asset": "USDC",
      "network": "ETHEREUM",
      "transaction_fee": {
        "value": "10.55",
        "asset": "USDC"
      },
      "platform_fee": {
        "value": "10.55",
        "asset": "USDC"
      },
      "partner_fee": {
        "value": "10.55",
        "asset": "USDC"
      },
      "source": {
        "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
        "external_account_id": "2e92e758-893e-11f0-b308-2eaa4f6974f2",
        "amount": "500",
        "asset": "USDC",
        "network": "ETHEREUM",
        "bank_name": "HSBC Bank USA, N.A.",
        "bank_account_name": "TechStart Holdings LLC"
      },
      "destination": {
        "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
        "external_account_id": "2e92e758-893e-11f0-b308-2eaa4f6974f2",
        "amount": "489.45",
        "asset": "USDC",
        "network": "ETHEREUM",
        "bank_name": "JPMorgan Chase Bank, N.A.",
        "bank_account_name": "TechStart Holdings LLC",
        "reference": "6471f23f-6b54-42e4-a2f3-febef7caac18"
      },
      "receiving_virtual_account": {
        "virtual_account_id": "VA-7K3M-9X2R"
      },
      "action_required": {
        "type": "RFI",
        "case_id": "TC-WXYZ-2345",
        "action": "SUBMIT_INFORMATION"
      },
      "memorandum": "first transaction",
      "created_at": "2025-08-21T07:56:57.981Z",
      "modified_at": "2025-08-21T07:56:57.981Z",
      "sub_transactions": [
        {
          "customer_id": "14f20ebd-893b-11f0-b308-2eaa4f6974f2",
          "account_id": "BZ-A2C4-9XPN",
          "recipient_id": "f77a8df1-a2b3-4c5d-9e8f-1234567890ab",
          "transaction_id": "aac5201f-7f1c-11f0-b018-de09fc637374",
          "amount": "500",
          "asset": "USDC",
          "network": "ETHEREUM",
          "transaction_fee": {
            "value": "10.55",
            "asset": "USDC"
          },
          "platform_fee": {
            "value": "10.55",
            "asset": "USDC"
          },
          "partner_fee": {
            "value": "10.55",
            "asset": "USDC"
          },
          "source": {
            "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
            "external_account_id": "2e92e758-893e-11f0-b308-2eaa4f6974f2",
            "amount": "500",
            "asset": "USDC",
            "network": "ETHEREUM",
            "bank_name": "HSBC Bank USA, N.A.",
            "bank_account_name": "TechStart Holdings LLC"
          },
          "destination": {
            "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
            "external_account_id": "2e92e758-893e-11f0-b308-2eaa4f6974f2",
            "amount": "489.45",
            "asset": "USDC",
            "network": "ETHEREUM",
            "bank_name": "JPMorgan Chase Bank, N.A.",
            "bank_account_name": "TechStart Holdings LLC",
            "reference": "6471f23f-6b54-42e4-a2f3-febef7caac18"
          },
          "receiving_virtual_account": {
            "virtual_account_id": "VA-7K3M-9X2R"
          },
          "action_required": {
            "type": "RFI",
            "case_id": "TC-WXYZ-2345",
            "action": "SUBMIT_INFORMATION"
          },
          "memorandum": "first transaction",
          "created_at": "2025-08-21T07:56:57.981Z",
          "modified_at": "2025-08-21T07:56:57.981Z"
        }
      ]
    }
  ],
  "total": 1024
}

Changes

    • warning

      added the new MICRO_DEPOSIT enum value to the ////// response property for the response status

    • warning

      added the new MICRO_DEPOSIT enum value to the ///////// response property for the response status

    • warning

      added the new MICRO_DEPOSIT_REVERSED enum value to the ////// response property for the response status

    • warning

      added the new MICRO_DEPOSIT_REVERSED enum value to the ///////// response property for the response status

    • info

      api tag crate::transaction::history::controller::openapi::transactions added

    • info

      api tag Transactions removed

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ///////// to the response with the status

    • info

      added the optional property ///////// to the response with the status

    • info

      added the optional property ///////// to the response with the status