Countries

List banks for a country

get/client/countries/{country}/banks

List the banks Lira can verify accounts against for a supported country.

Authorization

API key in the X-API-Key header.

Path parameters

countrystringrequired

ISO 3166-1 alpha-2 country code (e.g. NG, GH, ET, ZM, TZ)

Response

banksobject[]required

List of active banks supported for the requested country.

Show child attributes

idstringrequired

Bank code. Pass this exact value as `bankCode` when calling /verify/account.

namestringrequired

Display name of the bank.

const response = await fetch('https://api.uselira.com/api/v1/client/countries/{country}/banks', { method: 'GET', headers: { 'X-API-Key': 'YOUR_API_KEY', }, }); const data = await response.json();

{ "message": "NG Account Number verification is not enabled for your organisation.", "code": "SERVICE_NOT_ENABLED", "action": { "type": "CONTACT_ADMIN", "hint": "Ask your administrator to enable NG Account Number verification in the Lira dashboard." } }