Verifications

Batch verify BIC codes, routing numbers, and correspondent route lookups

post/verifications/batch

Submit up to 100 items in a single request. Each item specifies a `type` ("bic", "routing", or "route") and a `value`. Results are returned in the same order as the input. The batch endpoint always returns HTTP 200 — per-item validity is expressed inside each result object.

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

itemsobject[]required

Array of items to verify (1–100 items). Results are returned in the same order as the input.

Show child attributes

typestringrequired

Item type: "bic" for BIC/SWIFT validation, "routing" for ABA routing number validation, "route" for correspondent route lookup

Options: bicroutingroute

valuestringrequired

The value to validate or look up. Format depends on type: BIC (8 or 11 chars), routing number (9 digits), or BIC for route lookup.

Response

resultsobject[]required

One result per input item, in the same order as the input

Show child attributes

typestringrequired

Echoes the input item type

valuestringrequired

Echoes the input item value

resultobjectrequired

Validation or lookup result. Shape depends on type: bic → BicVerificationResponse fields; routing → RoutingVerificationResponse fields; route → { outcome:"found"|"no_route"|"invalid", bic, correspondents?, reason_code?, valid? }

curl -X POST 'https://api.lira.com/api/v1/verifications/batch' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "items": [ { "type": "bic", "value": "IRVTUS3NXXX" }, { "type": "routing", "value": "021000018" }, { "type": "route", "value": "AACSDE33XXX" } ] }'

const response = await fetch('https://api.lira.com/api/v1/verifications/batch', { method: 'POST', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ "items": [ { "type": "bic", "value": "IRVTUS3NXXX" }, { "type": "routing", "value": "021000018" }, { "type": "route", "value": "AACSDE33XXX" } ] }), }); const data = await response.json();

import requests response = requests.post( "https://api.lira.com/api/v1/verifications/batch", headers={"X-API-Key": "YOUR_API_KEY"}, json={ "items": [ { "type": "bic", "value": "IRVTUS3NXXX" }, { "type": "routing", "value": "021000018" }, { "type": "route", "value": "AACSDE33XXX" } ] }, ) data = response.json()

{ "results": [ { "type": "bic", "value": "IRVTUS3NXXX", "result": { "valid": true, "bic": "IRVTUS3NXXX", "institution_code": "IRVT", "country_code": "US", "location_code": "3N", "branch_code": "XXX", "is_test": false, "derived_country": "US" } }, { "type": "bic", "value": "BAD", "result": { "valid": false, "bic": "BAD", "reason_code": "INVALID_LENGTH" } }, { "type": "routing", "value": "021000018", "result": { "valid": true, "routing_number": "021000018", "normalized": "021000018", "checksum_ok": true } }, { "type": "routing", "value": "12345", "result": { "valid": false, "routing_number": "12345", "normalized": "12345", "checksum_ok": false, "reason_code": "INVALID_LENGTH" } }, { "type": "route", "value": "AACSDE33XXX", "result": { "outcome": "found", "bic": "AACSDE33XXX", "correspondents": [ { "name": "BNY MELLON", "bic": "IRVTUS3NXXX", "routing_number": "021000018", "account_number": "8900123456", "confidence": 0.95, "last_verified": "2025-01-15" } ] } }, { "type": "route", "value": "IRVTUS3NXXX", "result": { "outcome": "no_route", "bic": "IRVTUS3NXXX", "reason_code": "NO_ROUTE_FOUND", "correspondents": [] } } ] }

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