Logo
Swift API Sandbox Collections API Documentation

Check validity of account number formats, including IBANs.

GET {{baseUrl}}/account_numbers/:account_number/validity?country_code=IT&usage=retail&national_id=0542811101

Check validity of account number formats, including IBANs, issued in almost any country in the world.

 

Body PARAM

Key Datatype Required Description 
country_code
string ISO 2-letter country code of the country where the account is held
is_iban
boolean Whether the account number must be handled as an IBAN
usage
string How the account number is used (only for a few countries)
national_id
string National ID (bank ID, clearing code, sort code, routing number) of the account holding institution
bic
string BIC-8 or BIC-11 of the account holding institution



HEADERS

Key Datatype Required Description 
Accept
string




RESPONSES

Curl
curl -X GET 'https://sandbox.swift.com/swiftrefdata/v4/account_numbers/:account_number/validity?country_code=IT&usage=retail&national_id=0542811101?country_code=IT&is_iban=true&usage=retail&national_id=0542811101&bic=SWHTBEBBXXX' -H 'Accept: application/json'

ENDPOINTS