Verifications

Validate an ABA routing number

post/verifications/routing-codes

Validate a 9-digit ABA routing number. Performs digit-count and mod-10 checksum checks. Always returns HTTP 200 — validity is expressed in the `valid` field.

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

routing_numberstringrequired

ABA routing number (9 digits). Accepts a string or number; a numeric value is coerced to a string. Send as a string to preserve leading zeros — a JSON number drops them.

Response

validbooleanrequired

Whether the routing number passed all checks

routing_numberstringrequired

Original input as supplied

normalizedstringrequired

Digit-only, zero-padded to 9 characters

checksum_okbooleanrequired

Whether the ABA mod-10 checksum passed

reason_codestring

Reason for validation failure — present only when valid is false

Options: INVALID_LENGTHCHECKSUM_FAILED

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

import requests response = requests.post( "https://api.lira.com/api/v1/verifications/routing-codes", headers={"X-API-Key": "YOUR_API_KEY"}, json={ "routing_number": "021000018" }, ) data = 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." } }