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

# Banks

> Access bank reference data for supported countries

Retrieve reference data for supported banks. The returned `bankId` is required when creating recipients or initiating bank transfers.

## Endpoints

| Endpoint      | Method | Description              |
| ------------- | ------ | ------------------------ |
| `/bila/banks` | GET    | List all supported banks |

## Query Parameters

| Parameter | Type   | Description                         |
| --------- | ------ | ----------------------------------- |
| `country` | string | Filter banks by country code (`zm`) |

## Bank Object

```json theme={null}
{
  "id": "bank-001",
  "name": "Zambia National Commercial Bank",
  "code": "ZNBC",
  "country": "zm",
  "type": "bank"
}
```

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.usebila.com/api/v1/bila/banks?country=zm" \
    -H "x-api-key: sk_test_your_api_key"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.usebila.com/api/v1/bila/banks?country=zm', {
    headers: { 'x-api-key': 'sk_test_your_api_key' }
  });
  const banks = await response.json();
  ```
</CodeGroup>

## Supported Countries

| Country | Code | Banks Available |
| ------- | ---- | --------------- |
| Zambia  | `zm` | All major banks |

<a href="/docs/api-reference" style={{ textDecoration: 'none', borderBottom: 'none', display: 'block' }}>
  <div
    style={{
  borderRadius: '16px',
  padding: '32px',
  height: '120px',
  display: 'flex',
  flexDirection: 'column',
  justifyContent: 'flex-end',
  border: '0.5px solid #f16101',
  cursor: 'pointer',
  transition: 'all 0.15s ease-in-out',
  boxShadow: '0 4px 14px 0 rgba(241, 97, 1, 0.1)',
}}
    onMouseEnter={e => {
  e.currentTarget.style.background = 'rgba(241, 97, 1, 0.05)';
  e.currentTarget.style.boxShadow = '0 6px 20px 0 rgba(241, 97, 1, 0.2)';
  e.currentTarget.style.transform = 'translateY(-2px)';
}}
    onMouseLeave={e => {
  e.currentTarget.style.background = 'transparent';
  e.currentTarget.style.boxShadow = '0 4px 14px 0 rgba(241, 97, 1, 0.1)';
  e.currentTarget.style.transform = 'none';
}}
  >
    <div style={{ fontSize: '24px', marginBottom: '8px' }}>⟡</div>
    <div style={{ fontWeight: '500', fontSize: '16px' }}>API Reference</div>
    <div style={{ opacity: 0.6, fontSize: '13px', marginTop: '4px' }}>Explore the complete API reference</div>
  </div>
</a>