BIC Validation
Validate Bank Identifier Codes (BIC/SWIFT codes) and extract structured information about the institution, country, and branch.
Endpoint
GET /api/v1/bic/{bic}
Authentication
All requests require an API key passed via the X-Api-Key header.
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
- BIC codes can be 8 or 11 characters long
- 8-character codes represent the head office and are implicitly expanded with
XXXas the branch code - Also known as SWIFT codes or SWIFT-BIC
- Validation is structural only -- it checks format, length, and character constraints per ISO 9362