---
title: "GET /v1/customers/{customer_id}/external-accounts/list"
method: GET
path: "/v1/customers/{customer_id}/external-accounts/list"
tags: ["crate::connectivity::fiat::controller::openapi::external_accounts"]
---

# GET /v1/customers/{customer_id}/external-accounts/list

`GET /v1/customers/{customer_id}/external-accounts/list`

## Request

- Base URL: `https://api.1money.com`
- URL: `https://api.1money.com/v1/customers/{customer_id}/external-accounts/list`
- Auth: HTTP bearer

## Path parameters

- `customer_id` string, required

## Query parameters

- `currency` string: - 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
- `network` string: Public network identifier for bank, blockchain and internal transactions. Allowed values: - Bank: `US_ACH`, `US_FEDWIRE`, `US_RTP`, `US_FEDNOW`, `SWIFT`, `CUBIX`, `SPEI`, `PIX_TRANSFER`, `LOCAL_BANK_TRANSFER`, `CHATS`, `FPS`, `SEPA`, `FASTER_PAYMENT`, `UAEFTS`, `UPI`, `EREBOR_RAIL` - Blockchain: `ETHEREUM`, `POLYGON`, `ARBITRUM`, `AVALANCHE`, `BASE`, `BNBCHAIN`, `SOLANA`, `TRON`, `ONE_MONEY`, `BITCOIN` - Internal: `INTERNAL` Availability depends on the asset and customer account configuration.
- `include_recipient` boolean

## Response `200`

Successfully retrieved list of external accounts

- ExternalAccountResponse[]
  - `external_account_id` string, required: Unique identifier for the external account (UUID format). Use this ID for all subsequent operations (retrieve, delete, withdrawals).
  - `idempotency_key` string, required: Idempotency key associated with the account creation request. Used to prevent duplicate account creation and for retrieving accounts by idempotency key. Empty string if the account was created without an idempotency key.
  - `customer_id` string, required: Customer ID
  - `status` 'PENDING' | 'APPROVED' | 'FAILED', required: Current status of the bank account. - PENDING: Account is awaiting verification or approval - APPROVED: Account is verified and can be used for withdrawals - FAILED: Account verification failed or was rejected
  - `failure_reason` string, nullable: Customer-readable failure reason and next steps. Present only when status is FAILED.
  - `network` string, required: Bank network type for the external account. - `US_ACH`: For US domestic ACH transfers (next-day settlement, lower fees) - `US_FEDWIRE`: For US domestic wire transfers (same-day settlement) - `US_RTP`: For US real-time payments (instant settlement) - `SWIFT`: For international wire transfers via the SWIFT network - `SPEI`: For Mexican domestic transfers, addressed by an 18-digit CLABE - `LOCAL_BANK_TRANSFER`: For bank-account transfers over a local clearing network - `CHATS`: For Hong Kong USD transfers over CHATS - `FPS`: For Hong Kong HKD and CNY transfers over Faster Payment System (FPS) - `SEPA`: For EUR transfers to supported European bank accounts, addressed by IBAN
  - `nickname` string, nullable, required: User-defined nickname or label for the account (optional). Helps identify the account in listings.
  - `account_holder_name` string, required: Full legal name of the account holder (individual or entity). This is the name registered with the bank for compliance and verification.
  - `currency` string, required: Currency of the bank account (e.g., USD, EUR, GBP).
  - `country_code` 'AND' | 'ARE' | 'AFG' | 'ATG' | 'AIA' | 'ALB' | 'ARM' | 'AGO' | 'ARG' | 'ASM' | 'AUT' | 'AUS' | 'ABW' | 'AZE' | 'BIH' | 'BRB' | 'BGD' | 'BEL' | 'BFA' | 'BGR' | 'BHR' | 'BDI' | 'BEN' | 'BLM' | 'BMU' | 'BRN' | 'BOL' | 'BES' | 'BRA' | 'BHS' | 'BTN' | 'BWA' | 'BLR' | 'BLZ' | 'CAN' | 'CCK' | 'COD' | 'CAF' | 'COG' | 'CHE' | 'CIV' | 'COK' | 'CHL' | 'CMR' | 'CHN' | 'COL' | 'CRI' | 'CUB' | 'CPV' | 'CUW' | 'CXR' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DNK' | 'DMA' | 'DOM' | 'DZA' | 'ECU' | 'EST' | 'EGY' | 'ESH' | 'ERI' | 'ESP' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FSM' | 'FRO' | 'FRA' | 'GAB' | 'GBR' | 'GRD' | 'GEO' | 'GUF' | 'GGY' | 'GHA' | 'GIB' | 'GRL' | 'GMB' | 'GIN' | 'GLP' | 'GNQ' | 'GRC' | 'SGS' | 'GTM' | 'GUM' | 'GNB' | 'GUY' | 'HKG' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IRL' | 'ISR' | 'IMN' | 'IND' | 'IOT' | 'IRQ' | 'IRN' | 'ISL' | 'ITA' | 'JEY' | 'JAM' | 'JOR' | 'JPN' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'COM' | 'KNA' | 'PRK' | 'KOR' | 'KWT' | 'CYM' | 'KAZ' | 'LAO' | 'LBN' | 'LCA' | 'LIE' | 'LKA' | 'LBR' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'LBY' | 'MAR' | 'MCO' | 'MDA' | 'MNE' | 'MAF' | 'MDG' | 'MHL' | 'MKD' | 'MLI' | 'MMR' | 'MNG' | 'MAC' | 'MNP' | 'MTQ' | 'MRT' | 'MSR' | 'MLT' | 'MUS' | 'MDV' | 'MWI' | 'MEX' | 'MYS' | 'MOZ' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NIU' | 'NZL' | 'OMN' | 'PAN' | 'PER' | 'PYF' | 'PNG' | 'PHL' | 'PAK' | 'POL' | 'SPM' | 'PCN' | 'PRI' | 'PSE' | 'PRT' | 'PLW' | 'PRY' | 'QAT' | 'REU' | 'ROU' | 'SRB' | 'RUS' | 'RWA' | 'SAU' | 'SLB' | 'SYC' | 'SDN' | 'SWE' | 'SGP' | 'SHN' | 'SVN' | 'SJM' | 'SVK' | 'SLE' | 'SMR' | 'SEN' | 'SOM' | 'SUR' | 'SSD' | 'STP' | 'SLV' | 'SXM' | 'SYR' | 'SWZ' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TLS' | 'TKM' | 'TUN' | 'TON' | 'TUR' | 'TTO' | 'TUV' | 'TWN' | 'TZA' | 'UKR' | 'UGA' | 'USA' | 'URY' | 'UZB' | 'VAT' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XKX' | 'YEM' | 'MYT' | 'ZAF' | 'ZMB' | 'ZWE', required: ISO 3166-1 alpha-3 three-letter country code in uppercase (e.g., USA, GBR, DEU). Represents the country where the bank account is held.
  - `account_number` string, required
  - `institution_id` string: Routing identifier of the destination bank. For local bank transfers, this is the bank code selected from the supported institution list. Absent for SPEI, where the CLABE in `account_number` already encodes the bank.
  - `institution_name` string, required: Full legal name of the bank institution.
  - `institution_clearing_code` string, nullable, required: Additional local or regional routing codes required by specific payment networks or countries. Examples: Sort codes (UK), BSB numbers (Australia), transit numbers (Canada). For Japan LOCAL_BANK_TRANSFER in JPY, this is the three-digit branch code.
  - `intermediary_bank` IntermediaryBank, nullable: Intermediary bank information for `SWIFT` external accounts
    - `institution_id` string, required: The intermediary institution identifier (SWIFT code or ABA routing number). For USD international wires: ABA number of the US correspondent bank that serves as intermediary. For non-USD wires: SWIFT code of the intermediary bank (if required by the payment network). Required when the destination bank does not have a direct relationship with the sending institution.
  - `reference_code` string, nullable, required: Reference code for wire transfers (optional). A unique identifier that should be included in wire transfer memos to help identify and reconcile incoming payments.
  - `created_at` string, required: Timestamp when the account was created (ISO 8601 format with timezone). Reflects the initial registration time in the system.
  - `modified_at` string, required: Timestamp of the last modification to the account (ISO 8601 format with timezone). Updated when account details are changed or status is updated.
  - `recipient` RecipientResponse, nullable: Recipient response object
    - `recipient_id` string, required: Counterparty ID. Empty values are still allowed for legacy DB columns where an empty cpid means the record is not tied to a recipient.
    - `customer_id` string, required: Customer ID
    - `business_type` string, required: Recipient type: INDIVIDUAL or COMPANY
    - `full_name` string, required: Full name computed from name fields
    - `nickname` string, nullable: User-defined nickname (optional)
    - `email` string, nullable: Email address (optional)
    - `relationship` string, nullable: Relationship to the customer (optional)
    - `status` string, required: Recipient status. Possible values: success, pending_review, blocked
    - `address` AddressDetails, nullable
      - `full_address` string, required
      - `country_code` string, required: ISO 3166-1 alpha-3 three-letter country codes in upper case.
      - `address_line1` string, required: The street number for this address (the whitespaces are trimmed from field).
      - `address_line2` string, nullable: An additional address line for this address (the whitespaces are trimmed from field).
      - `city` string, required: A city for this address (the whitespaces are trimmed from field).
      - `region` string, nullable: The address's region. This is state for U.S., province for Canada (the whitespaces are trimmed from field).
      - `postal_code` string, required: A postal code for this address (the whitespaces are trimmed from field).
    - `action_required` ActionRequired, nullable
      - `type` string, required
      - `case_id` string, required: RFI case business ID.
      - `action` string, required
    - `created_at` string, date-time, required: Created timestamp
    - `modified_at` string, date-time, required: Last modified timestamp

## Other responses

- `400`: Invalid request parameters (e.g., invalid customer_id format, unsupported currency or network value)
- `401`: Authentication failed - Invalid or missing API key in request header
- `405`: Method not allowed - The HTTP method used is not supported for this endpoint
- `422`: Unprocessable Entity - Invalid enum value (e.g., unsupported network or asset name)
- `500`: Internal server error - Unexpected system error occurred during request processing

## Changes

- **2026-11-03** `d213edbaccb6`: 4 breaking, 1 warning, 4 info
  - the response property `items/institution_clearing_code` became nullable for the status `200`
  - the response property `items/nickname` became nullable for the status `200`
  - the response property `items/reference_code` became nullable for the status `200`
  - the response property `items/institution_id` became optional for the status `200`
  - …5 more

[Operation history](https://skmtc.dev/1money/apis/1money-openapi/changes/v1/customers/:customer_id/external-accounts/list/get.md)

---

[API](https://skmtc.dev/1money/apis/1money-openapi.md) - [All operations](https://skmtc.dev/1money/apis/1money-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/1money/apis/1money-openapi/revisions/d213edbaccb6?raw)
