IBAN & BIC Validation

Validate International Bank Account Numbers (IBAN) and Bank Identifier Codes (BIC/SWIFT). Returns structured information about the bank account including country, bank code, branch, and associated BIC.

Endpoints

GET /api/v1/iban/{iban}
GET /api/v1/bic/{bic}

Authentication

All requests require an API key passed via the X-Api-Key header.

IBAN Validation

Parameters

Parameter	Type	In	Required	Description
iban	string	path	Yes	IBAN to validate

Response

{
  "iban": "DE89370400440532013000",
  "valid": true,
  "countryCode": "DE",
  "bankCode": "37040044",
  "branchCode": null,
  "checkDigit": "89",
  "accountNumber": "0532013000",
  "bic": null,
  "bicValid": false
}

Response Fields

Field	Type	Description
iban	string	The normalized IBAN
valid	boolean	Whether the IBAN passes structural and checksum validation
countryCode	string	ISO 3166-1 alpha-2 country code
bankCode	string	National bank code extracted from the IBAN
branchCode	string	Branch code (if applicable for the country)
checkDigit	string	Two-digit check number (positions 3-4 of the IBAN)
accountNumber	string	Account number portion of the IBAN
bic	string	Associated BIC/SWIFT code (if resolvable)
bicValid	boolean	Whether the associated BIC is valid

Example

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://api.iqxlookup.neivi.es/api/v1/iban/DE89370400440532013000"

BIC Validation

Parameters

Parameter	Type	In	Required	Description
bic	string	path	Yes	BIC/SWIFT code to validate

Response

{
  "bic": "COBADEFFXXX",
  "valid": true,
  "bankCode": "COBA",
  "countryCode": "DE",
  "locationCode": "FF",
  "branchCode": "XXX"
}

Response Fields

Field	Type	Description
bic	string	The normalized BIC/SWIFT code
valid	boolean	Whether the BIC passes structural validation
bankCode	string	Institution code (first 4 characters)
countryCode	string	ISO 3166-1 alpha-2 country code (characters 5-6)
locationCode	string	Location code (characters 7-8)
branchCode	string	Branch code (characters 9-11, or "XXX" for head office)

Example

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://api.iqxlookup.neivi.es/api/v1/bic/COBADEFFXXX"

Notes

• IBAN validation includes both structural checks and ISO 7064 MOD 97-10 checksum verification
• BIC codes can be 8 or 11 characters; 8-character codes are implicitly head office (XXX branch)
• The bic field in the IBAN response is resolved from the bank code when a mapping is available