International Wire

Create an international wire transfer

POST/transfers/international-wire

Create an international wire transfer between a Column account and a counterparty. Transfer status can be tracked via the Tracking API.

Body Parameters

account_number_id

stringOptional

ID of the account number sending the transfer. Exactly one of bank_account_id or account_number_id must be provided.

allow_overdraft

booleanRequired

Whether overdraft is allowed for this transfer

amount

numberRequired

Amount in the smallest unit of the currency. e.g., 1756 means 1.756 in KWD, 17.56 in USD, or 1756 in JPY.

bank_account_id

stringOptional

ID of the bank account sending the transfer. Exactly one of bank_account_id or account_number_id must be provided.

charge_bearer

stringRequired

The charge bearer code. Can be DEBT, CRED, or SHAR.

counterparty_id

stringRequired

ID of the counterparty receiving the transfer

currency_code

stringRequired

Currency code (ISO 4217). e.g. EUR, GBP, JPY.

description

stringRequired

A description of the transfer

fx_quote_id

stringRequired

The ID of an FX quote to use for this transfer

intermediary_bank

stringRequired

SWIFT BIC of the intermediary bank

message_to_beneficiary_bank

stringRequired

Message to the beneficiary bank

purpose_code

stringRequired

Purpose code for the transfer

remittance_info

objectRequired

Remittance information for the transfer

beneficiary_reference

stringOptional

Reference for the beneficiary

general_info

stringOptional

General remittance information

ultimate_originator_counterparty

objectOptional

Inline ultimate originator counterparty details. See counterparty creation for full field reference.

account_number

stringRequired

The account number for the bank account.

account_type

stringRequired

The type of the account number. Can be checking or savings.

address

objectRequired

Addresses need to adhere to character validation, as addresses are used across multiple payment rails. Characters are validated according to the Fedwire character validation.

city

stringRequired

City name

country_code

stringRequired

Two-letter ISO 3166-1 alpha-2 country code (e.g. US)

line_1

stringRequired

Street address line 1

line_2

stringOptional

Street address line 2

postal_code

stringOptional

Postal or ZIP code

state

stringOptional

State or province

description

stringRequired

Description of the counterparty visible only in your platform. Maximum length: 127 characters.

email

stringRequired

The email address of the beneficiary.

legal_id

stringRequired

The legal ID (e.g., Tax ID, Cedula Juridica, etc.) of the beneficiary. This field is recommended for international wire transfers, and required in some countries. Maximum length: 127 characters.

legal_type

stringRequired

The legal entity type of the beneficiary. Can be business, non_profit, individual, or sole_proprietor. This field is recommended for international wire transfers, and required in some countries.

local_account_number

stringRequired

The local account number (e.g. Cuenta Cliente in Costa Rica) in the beneficiary's bank. This field is recommended for international wire transfers, and required in some countries. Maximum length: 63 characters.

local_bank_code

stringRequired

The local bank code of the beneficiary's bank (e.g., India IFSC, Australia BSB, China CNAPS, etc.). This field is recommended for international wire transfers, and required in some countries. Maximum length: 63 characters.

local_bank_country_code

stringRequired

The ISO 3166-1 alpha-2 country code of the beneficiary's local bank.

local_bank_name

stringRequired

Name of the beneficiary's local bank.

name

stringRequired

The counterparty name who owns the bank account. There is a 127 character limit for this field. For domestic wires, only the first 35 characters are included in the wire message.

phone

stringRequired

The phone number of the beneficiary. This field is recommended for international wire transfers, and required in some countries. Maximum length: 31 characters.

routing_number

stringRequired

The routing number of the bank.

routing_number_type

stringRequired

The type of the routing number. Can be aba, bic, or other.

wire

objectRequired

Wire-specific details for this counterparty, including beneficiary information and local bank details.

beneficiary_address

objectRequired

The address of the wire beneficiary.

city

stringRequired

City name

country_code

stringRequired

Two-letter ISO 3166-1 alpha-2 country code (e.g. US)

line_1

stringRequired

Street address line 1

line_2

stringOptional

Street address line 2

postal_code

stringOptional

Postal or ZIP code

state

stringOptional

State or province

beneficiary_email

stringRequired

The email address of the wire beneficiary.

beneficiary_legal_id

stringRequired

The legal identification number of the wire beneficiary (e.g. EIN or SSN).

beneficiary_name

stringRequired

The name of the wire beneficiary.

beneficiary_phone

stringRequired

The phone number of the wire beneficiary.

beneficiary_type

stringRequired

The type of the wire beneficiary. Possible values: individual, business

local_account_number

stringRequired

The local account number at the beneficiary's bank (used for international counterparties).

local_bank_code

stringRequired

The local bank code of the beneficiary's bank (used for international counterparties).

wire_drawdown_allowed

booleanRequired

Whitelists counterparties for automatic approval of drawdown requests to Column via Fedwire. If false, all inbound drawdown requests from this counterparty will require explicit approval.

ultimate_originator_counterparty_id

stringRequired

ID of the ultimate originator counterparty