> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conduit.financial/llms.txt
> Use this file to discover all available pages before exploring further.

# Look up a bank by BIC

> Get the bank name and address of a BIC before you create a SWIFT payout

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}`](https://docs.conduit.financial/api-reference/bank-directory/look-up-the-bank-of-a-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.

> [!WARNING]
>
> **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.

> [!NOTE]
>
> **Test this flow in sandbox.** The sandbox answers from the same bank
> directory as live. The [sandbox cheat sheet](https://docs.conduit.financial/sandbox/cheat-sheet.md) 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

```bash theme={null}
curl https://api.conduit.financial/v2/bank-directory/bics/REVOIE23 \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
{
  "bic": "REVOIE23",
  "bankName": "REVOLUT BANK UAB IRELAND BRANCH",
  "bankAddress": {
    "addressLine1": "2 DUBLIN LANDINGS",
    "addressLine2": "1 NORTH DOCK",
    "city": "DUBLIN",
    "state": "CO DUBLIN",
    "postalCode": "D01 V4A3",
    "country": "IRL"
  }
}
```

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`](https://docs.conduit.financial/guides/send-payout). 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

| Status | `type` | Cause |
| - | - | - |
| `400` | `VALIDATION_ERROR` | The BIC is not 8 or 11 characters of the right format, for example a BIC in lower case. |
| `404` | `NOT_FOUND` | Conduit has no bank for this BIC. Check the BIC with your customer, or send `bankName` and `bankAddress` on the payout. |
| `429` | `RATE_LIMITED` | You sent too many requests in a short time. Wait for the time in `Retry-After`. |

## What happens next

[Send the payout](https://docs.conduit.financial/guides/send-payout.md) to the recipient at this bank.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.