Bank Routing

Look up correspondent banks for a foreign BIC

post/verifications/correspondents

Returns the correspondent banks on file for the given foreign BIC, sorted by confidence descending. Returns 404 when the BIC is structurally valid but no routes are on file, and 422 when the BIC fails structural validation. Each lookup is recorded and billed — supply an Idempotency-Key so retries replay without re-charging.

Authorization

API key in the X-API-Key header.

Headers

Idempotency-Keystringrequired

Required. Unique printable-ASCII key (1-255 chars) per logical request; retries with the same key replay the original result without re-charging.

Body required

bicstringrequired

The foreign BIC/SWIFT code to look up correspondents for. 8 or 11 characters.

Response

bicstringrequired

The queried foreign BIC, uppercased

correspondentsobject[]required

Correspondent banks sorted by confidence descending

Show child attributes

namestringrequired

Canonical name of the correspondent bank

bicstringrequired

BIC/SWIFT code of the correspondent bank

routing_numberstringrequired

ABA routing number (9 digits)

account_numberstring | nullrequired

Nostro account number (null when not on file)

confidencenumberrequired

Route confidence score (0.0–1.0)

last_verifiedstringrequired

Date last verified, YYYY-MM-DD

reason_codestring

Present only on 404 — NO_ROUTE_FOUND when no routes exist for this BIC

const response = await fetch('https://api.lira.com/api/v1/verifications/correspondents', { method: 'POST', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ "bic": "AACSDE33XXX" }), }); const data = await response.json();

import requests response = requests.post( "https://api.lira.com/api/v1/verifications/correspondents", headers={"X-API-Key": "YOUR_API_KEY"}, json={ "bic": "AACSDE33XXX" }, ) data = response.json()

{ "bic": "AACSDE33XXX", "correspondents": [ { "name": "BNY MELLON", "bic": "IRVTUS3NXXX", "routing_number": "021000018", "account_number": "8900123456", "confidence": 0.95, "last_verified": "2025-01-15" } ], "reason_code": "NO_ROUTE_FOUND" }

{ "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." } }