Skip to main content
Before you send a SWIFT payout, you can show your customer the bank behind the BIC they typed. Send the BIC to GET /v2/bank-directory/bics/{bic}. You get back the bank name and address that Conduit holds for it. These are the same values that Conduit fills in when you create a SWIFT payout with no bankAddress. The lookup is optional and moves no money.
The answer is advisory. Check the bank name and address with your customer or the recipient before you send the payout. Conduit pays the account that the payout names, whatever bank the lookup showed.
Test this flow in sandbox. The sandbox answers from the same bank directory as live. The sandbox cheat sheet lists the sandbox host and the key format.

Prerequisites

  • Your API key. A read-only key can send this request.
  • The BIC of the recipient’s bank: 8 or 11 characters, in upper case.

Step 1 — Look up the BIC

An 11-character BIC names a branch. The answer gives the bank of its first 8 characters, which is the head office. bic in the answer is the BIC you sent. The route changes no data, so you can retry it. It takes no Idempotency-Key.

Step 2 — Use the answer on the payout

bankAddress has the same shape as the bankAddress of a SWIFT recipient on POST /v2/payouts. You can:
  • send the payout with no bankAddress and no bankName, and Conduit fills in these values, or
  • send bankName and bankAddress as you received them, or as your customer corrected them.

Errors

What happens next

Send the payout to the recipient at this bank.