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.
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
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
bankAddressand nobankName, and Conduit fills in these values, or - send
bankNameandbankAddressas you received them, or as your customer corrected them.