# Bank Directory



Every licensed Indonesian bank — clearing code, SWIFT BIC, readable name, and head-office contact — the lookup every payment flow starts with.



## Bank Directory Search

Search every licensed Indonesian bank by name, brand, BI clearing code, or SWIFT BIC — with head-office address, phone, and website, from the OJK directory.

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

**Parameters**

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

**Example request**

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

**Example response**

```json
{
  "data": {
    "total": 1,
    "banks": [
      {
        "code": "014",
        "name": "PT BANK CENTRAL ASIA Tbk",
        "common_name": "Bank Central Asia",
        "short_name": "BCA",
        "swift_bic": "CENAIDJA",
        "type": "national_private",
        "sharia": false,
        "address": "Menara BCA, Grand Indonesia, Lt. 23 Jl. M.H Thamrin No. 1, Jakarta 10310",
        "phone": "(021) 2358-8000",
        "website": "www.bca.co.id",
        "brands": []
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
```

**MCP**: callable from any AI agent via `call_api` with endpoint `banks-search` — https://mcp.diraz.co.id/mcp

## Bank Code Lookup

One BI clearing code in full — names, SWIFT BIC, head-office contact, 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.co.id/v1/banks/%7Bcode%7D \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "banks": [
      {
        "code": "022",
        "name": "PT BANK CIMB NIAGA Tbk",
        "common_name": "Bank CIMB Niaga",
        "short_name": "BANK CIMB",
        "swift_bic": "BNIAIDJA",
        "type": "national_private",
        "sharia": false,
        "address": "Graha Niaga / Niaga Tower Jl. Jend. Sudirman Kav. 58, Jakarta 12190",
        "phone": "(021) 2505252, 2505353",
        "website": "www.cimbniaga.co.id",
        "brands": []
      },
      {
        "code": "022",
        "name": "PT BANK CIMB NIAGA Tbk - UNIT USAHA SYARIAH",
        "common_name": "Bank CIMB Niaga Sharia Unit",
        "short_name": "BANK CIMB UUS",
        "swift_bic": "SYNAIDJ1",
        "type": "national_private",
        "sharia": true,
        "address": "Graha Niaga / Niaga Tower Jl. Jend. Sudirman Kav. 58, Jakarta 12190",
        "phone": "(021) 2505252, 2505353",
        "website": "www.cimbniaga.co.id",
        "brands": []
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
```

**MCP**: callable from any AI agent via `call_api` with endpoint `banks-lookup` — https://mcp.diraz.co.id/mcp