# Bank Directory



Every Indonesian bank's clearing code and SWIFT BIC — search by name, look a code up, the lookup every payment flow starts with.



## Bank Directory Search

Search every Indonesian bank by name, BI clearing code, or SWIFT BIC — the code an interbank transfer or international wire is addressed with.

- Method: `GET`
- Path: `/v1/banks`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `q` | string | optional | Keyword against the bank's name or short name, a clearing code (`014`), or a BIC fragment (`IDJA`). |
| `limit` | integer | optional | Entries per page. |

**Example request**

```bash
curl https://api.diraz.ae/v1/banks \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "total": 1,
    "banks": [
      { "code": "014", "office_code": "0397", "swift_bic": "CENAIDJA", "name": "PT BANK CENTRAL ASIA TBK", "short_name": "BCA" }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
```

## Bank Code Lookup

One BI clearing code in full — the bank's names, SWIFT BIC, and every entry sharing the code, Sharia units included.

- Method: `GET`
- Path: `/v1/banks/{code}`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `code` | path segment | required | Three-digit BI clearing code, e.g. `014` for BCA. |

**Example request**

```bash
curl https://api.diraz.ae/v1/banks/%7Bcode%7D \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "banks": [
      { "code": "022", "office_code": "0026", "swift_bic": "BNIAIDJA", "name": "PT. BANK CIMB NIAGA TBK", "short_name": "BANK CIMB" },
      { "code": "022", "office_code": "9920", "swift_bic": "SYNAIDJ1", "name": "PT. BANK CIMB NIAGA TBK - UNIT USAHA SYARIAH", "short_name": "BANK CIMB NIAGA UUS" }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
```