Veille

IBAN Validation

GET
/v1/vat/iban

Validate any IBAN and retrieve associated bank details. Returns the BIC/SWIFT code, bank name, country, BBAN structural breakdown, and SEPA zone membership.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

The IBAN to validate (e.g. FR7630006000011234567890189).

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
bic?string
bban?string
iban?string
valid?boolean
bank_code?string
bank_name?string
branch_code?string
country_code?string
country_name?string
in_sepa_zone?boolean
account_number?string
checksum_digits?string
Example Request
curl -X GET 'https://api.veille.io/v1/vat/iban?query=string'
Example Response
{  "bic": "AGRIFRPPXXX",  "bban": "30006000011234567890189",  "iban": "FR7630006000011234567890189",  "valid": true,  "bank_code": "30006",  "bank_name": "CREDIT AGRICOLE SA",  "branch_code": "00001",  "country_code": "FR",  "country_name": "France",  "in_sepa_zone": true,  "account_number": "12345678901",  "checksum_digits": "76"}