v1

latestOpenAPI 3.1.0Proprietary2026-07-2464170247.4 KB

Recipients (Send to Others)

List Recipient Bank Accounts

Retrieve all bank accounts associated with a specific recipient.

Functionality:

Supports filtering by currency and network type
The list is ordered by creation date (most recent first)

get/v1/customers/{customer_id}/recipients/{recipient_id}/bank_accounts/list

Path parameters

customer_idstring required

Unique identifier of the customer

recipient_idstring required

Unique identifier of the recipient

Query parameters

currencystring

Stablecoin assets: USDC, USDT, PYUSD, RLUSD, USDG, USDP, EURC, MXNB, 1USD(1USD/USDC conversion only, deposit/withdrawal not supported)
Digital assets: BTC
Fiat currencies: USD

Example:USDC

Filter by currency code

If not provided, returns accounts in all currencies. Currently, only USD accepted.

networkstring

Example:ETHEREUM

Filter by bank network type.

If not provided, returns accounts in all networks.
If provided, returns only accounts using the specified network (US_FEDWIRE, US_ACH, US_RTP, SWIFT, CUBIX, BANK_TRANSFER, or PIX_TRANSFER)

include_recipientboolean

Whether to include recipient (third-party) bank accounts in the results.

If false or not provided, only returns the customer's own (first-party) bank accounts.
If true, also includes bank accounts belonging to recipients, each with a recipient object attached.

Response

Successfully retrieved list of bank accounts

totalinteger nullable

Example response

{
  "list": [
    {
      "external_account_id": "381b013e-8893-11f0-b308-2eaa4f6974f2",
      "customer_id": "14f20ebd-893b-11f0-b308-2eaa4f6974f2",
      "network": "ETHEREUM",
      "nickname": "Primary Operating Account",
      "account_holder_name": "TechStart Holdings LLC",
      "currency": "USDC",
      "account_number": "4447891623",
      "institution_id": "CHASUS33",
      "institution_name": "JPMorgan Chase Bank, N.A.",
      "institution_clearing_code": "021000021",
      "intermediary_bank": {
        "institution_id": "PNBPUS3NNYC"
      },
      "reference_code": "36AC1ECAF659",
      "created_at": "2025-08-21T07:56:57.981Z",
      "modified_at": "2025-08-21T07:56:57.981Z",
      "recipient": {
        "recipient_id": "4728c2b9-6df7-11f0-b1f6-6a7838eca3f8",
        "customer_id": "14f20ebd-893b-11f0-b308-2eaa4f6974f2",
        "business_type": "INDIVIDUAL",
        "full_name": "John Doe",
        "nickname": "John's Business",
        "email": "john.doe@example.com",
        "relationship": "VENDOR",
        "status": "active",
        "address": {
          "full_address": "490 2nd St Suite 300, San Francisco, CA 94107",
          "country_code": "USA",
          "address_line1": "490 2nd St",
          "address_line2": "Suite 300",
          "city": "San Francisco",
          "region": "CA",
          "postal_code": "94107"
        },
        "created_at": "2025-10-29T02:46:25.096305Z",
        "modified_at": "2025-10-29T02:46:25.096305Z"
      },
      "recipient_id": "4728c2b9-6df7-11f0-b1f6-6a7838eca3f8"
    }
  ],
  "total": 1024
}