Validación de IBAN y BIC

Valida números de cuenta bancaria internacionales (IBAN) y códigos de identificación bancaria (BIC/SWIFT). Devuelve información estructurada sobre la cuenta bancaria incluyendo país, código de banco, sucursal y BIC asociado.

Endpoints

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

Autenticación

Todas las solicitudes requieren una API key enviada mediante el header X-Api-Key.

Validación de IBAN

Parámetros

Parámetro	Tipo	En	Obligatorio	Descripción
iban	string	path	Sí	IBAN a validar

Respuesta

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

Campos de la Respuesta

Campo	Tipo	Descripción
iban	string	El IBAN normalizado
valid	boolean	Si el IBAN pasa la validación estructural y de checksum
countryCode	string	Código de país ISO 3166-1 alpha-2
bankCode	string	Código de banco nacional extraído del IBAN
branchCode	string	Código de sucursal (si aplica para el país)
checkDigit	string	Número de control de dos dígitos (posiciones 3-4 del IBAN)
accountNumber	string	Porción del número de cuenta del IBAN
bic	string	Código BIC/SWIFT asociado (si es resoluble)
bicValid	boolean	Si el BIC asociado es válido

Ejemplo

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

Validación de BIC

Parámetros

Parámetro	Tipo	En	Obligatorio	Descripción
bic	string	path	Sí	Código BIC/SWIFT a validar

Respuesta

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

Campos de la Respuesta

Campo	Tipo	Descripción
bic	string	El código BIC/SWIFT normalizado
valid	boolean	Si el BIC pasa la validación estructural
bankCode	string	Código de institución (primeros 4 caracteres)
countryCode	string	Código de país ISO 3166-1 alpha-2 (caracteres 5-6)
locationCode	string	Código de localización (caracteres 7-8)
branchCode	string	Código de sucursal (caracteres 9-11, o "XXX" para oficina principal)

Ejemplo

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

Notas

• La validación de IBAN incluye tanto verificaciones estructurales como la verificación de checksum ISO 7064 MOD 97-10
• Los códigos BIC pueden tener 8 u 11 caracteres; los códigos de 8 caracteres corresponden implícitamente a la oficina principal (sucursal XXX)
• El campo bic en la respuesta de IBAN se resuelve a partir del código de banco cuando existe un mapeo disponible