Skip to content
Lira APILira API

Verifications

Validate a BIC/SWIFT code

post/verifications/bic

Validate a BIC/SWIFT code (ISO 9362). Returns parsed components on success or a structured reason code on failure.

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

BIC/SWIFT code, 8 or 11 characters

Response

validbooleanrequired

Whether the BIC is structurally valid

bicstringrequired

Normalised (trimmed + uppercased) BIC

institution_codestring

First 4 characters — institution identifier

country_codestring

Characters 5–6 — ISO 3166-1 alpha-2 country code embedded in the BIC

location_codestring

Characters 7–8 — location code

branch_codestring | null

Characters 9–11 — branch code (null when BIC is 8 chars)

is_testboolean

True when the second character of the location code is "0" (test BIC per ISO 9362)

derived_countrystring

Set when the embedded country code is a valid ISO 3166-1 alpha-2 country

reason_codestring

Reason for validation failure — present only when valid is false

Options: INVALID_LENGTHINVALID_CHARSETINVALID_STRUCTURE