INinfinite
External Bank Accounts

Close an external account

Changed on

Closes an active external account. Accounts still in review cannot be closed. The account can no longer be used as a transfer or FX destination, and linked fixed routes are disabled. Creating an external account later with the same bank details or proxy alias reopens this account with the same ID. Disabled fixed routes are not re-enabled automatically.

post/v1/external-bank-accounts/{id}/close

Request

Path parameters

idstring required

External account ID

Headers

X-API-Keystring

API key

Response

External account closed successfully

idstring required

Account ID

customerIdstring required

Customer ID

counterpartyIdstring nullable

Counterparty ID when this is a third-party recipient account

type'EXTERNAL_BANK' | 'EXTERNAL_PROXY' required

Account type

status'IN_REVIEW' | 'ACTIVE' | 'CLOSED' required

Account status

beneficiaryType'INDIVIDUAL' | 'BUSINESS' required

Beneficiary type

beneficiaryNamestring required

Beneficiary name

paymentRail'ACH' | 'ACH_SAME_DAY' | 'WIRE' | 'FEDWIRE' | 'FED_NOW' | 'RTP' | 'EREBOR' | 'EREBOR_RAIL' | 'BALANCE' | 'SWIFT' | 'SEPA' | 'SEPA_INSTANT' | 'TIPS' | 'FASTER_PAYMENTS' | 'BACS' | 'CHAPS' | 'ELIXIR' | 'NICS' | 'EFT' | 'INTERAC' | 'NPP' | 'BECS' | 'UPI' | 'IMPS' | 'IMPS_WITH_FIRC' | 'NEFT' | 'RTGS' | 'BI_FAST' | 'ARTAJASA' | 'PIX' | 'TED' | 'TEF' | 'SPEI' | 'COELSA' | 'SINPE' | 'CNAPS' | 'CIPS' | 'CFXPS' | 'CHATS' | 'ZENGIN' | 'KFTC' | 'FAST_SG' | 'MEPS' | 'DUITNOW' | 'PROMPTPAY' | 'INSTAPAY' | 'PESONET' | 'NAPAS' | 'BEFTN' | 'SLIPS' | 'ZAHAV' | 'GHIPSS' | 'NIBSS' | 'PESALINK' | 'RTC_ZA' | 'TZS_RTGS' | 'EGP_ACH' | 'JOD_ACH' | 'NPSS' | 'MADA' | 'QPS' | 'DOP_ACH' | 'GTQ_ACH' | 'HNL_ACH' | 'PEN_ACH' | 'JMD_ACH' | 'USD_ACH_SV' | 'USD_ACH_EC' | 'CLP_TEF' | 'PSE' | 'COP_ACH' | 'BOB_RTGS' | 'PYG_ACH' | 'CERTIS' | 'DKK_TIPS' | 'SENT' | 'NKS' | 'BANKGIROT' | 'HKD_FPS' | 'IBFT' | 'TRY_FAST' required

Primary payment rail for this account

paymentRailsstring[]

All payment rails this account supports (bank accounts only)

beneficiaryPhonestring nullable

Beneficiary phone number

beneficiaryDateOfBirthstring date

Account holder's date of birth

bankNamestring nullable

Bank name (bank accounts only)

swiftBicstring nullable

SWIFT/BIC code (bank accounts only)

ibanstring nullable

IBAN (bank accounts only)

accountNumberstring nullable

Bank account number (bank accounts only)

routingNumberstring nullable

Bank routing code (ABA routing number, sort code, BSB, IFSC, etc.)

branchCodestring nullable

Bank branch code (for countries like Japan, Brazil, South Africa that use separate branch identifiers)

beneficiaryDocumentTypestring

Type of the beneficiary's national/tax identification document (rail-specific codes, e.g. CC/NIT for Colombia, RUT for Chile)

beneficiaryDocumentNumberstring

The beneficiary's national/tax identification document number

beneficiaryStateProvincestring

The beneficiary's state/department/province (rails that require it on payouts, e.g. Peru ACH)

correspondentBankNamestring nullable

Correspondent/intermediary bank name (SWIFT)

correspondentBankSwiftCodestring nullable

Correspondent/intermediary bank SWIFT/BIC code (SWIFT)

correspondentAccountNumberstring nullable

Correspondent/intermediary account number (SWIFT)

bankAccountType'checking' | 'savings' nullable

Bank account type (bank accounts only)

currencyCodesstring[] nullable

Supported currency codes

aliasType'PHONE' | 'EMAIL' | 'NATIONAL_ID' | 'TAX_ID' | 'RANDOM' | 'CORPORATE_ID' nullable

Type of proxy alias (proxy accounts only)

aliasValuestring nullable

The proxy alias value (proxy accounts only)

createdAtstring date-time required

Account creation date

updatedAtstring date-time required

Account last update date

createdboolean

Present on create responses. true = a new account was inserted. false = an existing account matched (bank: customer + the exact normalized identifier set supplied; proxy: customer + alias + rail) and was reused. For bank accounts, existing paymentRails are not updated by create — use PATCH to add rails; missing create-only fields may still be backfilled and conflicting values return 400. For proxy accounts, inspect paymentRail (proxies do not return paymentRails).

Example response

{
  "id": "eba_1234567890abcdef",
  "customerId": "cust_abc123",
  "counterpartyId": "cp_abc123",
  "type": "EXTERNAL_BANK",
  "status": "IN_REVIEW",
  "beneficiaryType": "INDIVIDUAL",
  "beneficiaryName": "John Smith",
  "metadata": {
    "nickname": "Main Checking Account",
    "purpose": "Business operations",
    "tags": [
      "primary",
      "operations"
    ]
  },
  "paymentRail": "SWIFT",
  "paymentRails": [
    "ACH",
    "ACH_SAME_DAY",
    "WIRE"
  ],
  "beneficiaryAddress": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Suite 100",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  },
  "beneficiaryPhone": "+12125551234",
  "beneficiaryDateOfBirth": "1990-01-31",
  "bankName": "JPMorgan Chase Bank",
  "bankAddress": {
    "addressLine1": "270 Park Avenue",
    "addressLine2": "Floor 10",
    "city": "New York",
    "state": "NY",
    "postalCode": "10017",
    "country": "US"
  },
  "swiftBic": "CHASUS33",
  "iban": "GB82WEST12345698765432",
  "accountNumber": "1234567890",
  "routingNumber": "021000021",
  "branchCode": "001",
  "beneficiaryDocumentType": "CC",
  "beneficiaryDocumentNumber": "12345678901",
  "beneficiaryStateProvince": "LIMA",
  "correspondentBankName": "Bank of America",
  "correspondentBankSwiftCode": "IRVTUS3NXXX",
  "correspondentAccountNumber": "9876543210",
  "bankAccountType": "checking",
  "currencyCodes": [
    "USD",
    "EUR"
  ],
  "aliasType": "TAX_ID",
  "aliasValue": "12345678901",
  "createdAt": "2026-01-15T10:00:00Z",
  "updatedAt": "2026-01-15T10:00:00Z",
  "created": true
}

Changes

  • 7072bd7fdeb7Revision changes
    • warning

      added the new CNAPS enum value to the response property for the response status

    • warning

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