increase-test
POST/swift_transfers

Create a Swift Transfer

Creates a Swift Transfer to send funds internationally. Provide the source account details, creditor and debtor information, amount, currency, and remittance information; instructed_currency must be USD. Include a valid creditor BIC and address details that meet the field length and character constraints.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

14 body fields

Swift Transfer details. Include all required fields; creditor and debtor addresses each require line1, city, and country.

account_idstringrequired
The identifier for the account that will send the transfer.
account_numberstringrequired
The creditor's account number.
bank_identification_codestringrequired
The bank identification code (BIC) of the creditor. If it ends with the three-character branch code, this must be 11 characters long. Otherwise this must be 8 characters and the branch code will be assumed to be `XXX`.
creditor_addressobjectrequired
The creditor's address.
creditor_namestringrequired
The creditor's name.
debtor_addressobjectrequired
The debtor's address.
debtor_namestringrequired
The debtor's name.
instructed_amountintegerrequired
The amount, in minor units of `instructed_currency`, to send to the creditor.
instructed_currencystringrequired
The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the instructed amount.
Allowed:USD
intermediary_bank_identification_codestringoptional
The bank identification code (BIC) of the intermediary bank, if the transfer should be routed through one.
require_approvalbooleanoptional
Whether the transfer requires explicit approval via the dashboard or API.
routing_numberstringoptional
The creditor's bank account routing or transit number. Required in certain countries.
source_account_number_idstringrequired
The Account Number to include in the transfer as the debtor's account number.
unstructured_remittance_informationstringrequired
Unstructured remittance information to include in the transfer.

3 status codes
200Returns the created Swift Transfer, including its identifier, amount, instructed currency, creditor and debtor details, and creation metadata.
account_idstringrequired
The Account to which the transfer belongs.
account_numberstringrequired
The creditor's account number.
amountintegerrequired
The transfer amount in USD cents.
bank_identification_codestringrequired
The bank identification code (BIC) of the creditor.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was created.
created_byobjectrequired
What object created the transfer, either via the API or the dashboard.
creditor_addressobjectrequired
The creditor's address.
creditor_namestringrequired
The creditor's name.
debtor_addressobjectrequired
The debtor's address.
debtor_namestringrequired
The debtor's name.
idstringrequired
The Swift transfer's identifier.
idempotency_keystringrequired
The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
instructed_amountintegerrequired
The amount that was instructed to be transferred in minor units of the `instructed_currency`.
instructed_currencystringrequired
The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the instructed amount.
Allowed:USD
intermediary_bank_identification_codestringrequired
The bank identification code (BIC) of the intermediary bank, if the transfer is routed through one.
pending_transaction_idstringrequired
The ID for the pending transaction representing the transfer.
routing_numberstringrequired
The creditor's bank account routing or transit number. Required in certain countries.
source_account_number_idstringrequired
The Account Number included in the transfer as the debtor's account number.
statusstringrequired
The lifecycle status of the transfer.
Allowed:pending_approvalcanceledpending_initiatingpending_reviewingrequires_attentioninitiatedrejectedreturned
transaction_idstringrequired
The ID for the transaction funding the transfer. This will be populated after the transfer is initiated.
typestringrequired
A constant representing the object's type. For this resource it will always be `swift_transfer`.
Allowed:swift_transfer
unique_end_to_end_transaction_referencestringrequired
The Unique End-to-end Transaction Reference ([UETR](https://www.swift.com/payments/what-unique-end-end-transaction-reference-uetr)) for the transfer.
unstructured_remittance_informationstringrequired
The unstructured remittance information that was included with the transfer.
4XXReturned when the request fails with a client error.
5XXReturned when the request fails with a server error.

Error handling

account_id, source_account_number_id, account_number, bank_identification_code, instructed_amount, instructed_currency, unstructured_remittance_information, creditor_name, creditor_address, debtor_name, and debtor_address are required. instructed_currency must be USD, instructed_amount must be at least 1, and the creditor and debtor addresses must each include line1, city, and country; BIC values must be 8 or 11 valid characters.