BWValidateIBAN service

You use the BWValidateIBAN service to check that the supplied IBAN is in the correct format and that the account could exist. This also validates the BBAN created by decomposing the IBAN.

To validate the IBAN, all you need to supply is the IBAN.

This service returns:

country - 2 character ISO country code
conditions - all errors, warnings and information messages returned by the service, these show whether the validation was successful
BBAN - between 1 and 5 fields containing the domestic account details decomposed from the IBAN
data access key - you must pass the data access key to the bank data retrieval services to retrieve any of the bank data.

SOAP messages

Request

<soapenv:Body>

<ns:BWValidateIBANRequest>

<eih:EIHHeader>

<eih:ClientUser>user</eih:ClientUser>

<eih:ReferenceId>123</eih:ReferenceId>

</eih:EIHHeader>

<ns:ValidateIBANRequest language="en" reportString="1123" itemisationID="1122">GB87BRNU07011600006555</ns:ValidateIBANRequest>

</ns:BWValidateIBANRequest>

</soapenv:Body>

Response

<SOAP-ENV:Body>

<eih:BWValidateIBANResponse>

<header:EIHHeader>

<header:ClientUser>user</header:ClientUser>

<header:ReferenceId>123</header:ReferenceId>

</header:EIHHeader>

<bws:BBAN description="Sort code" index="1">070116</bws:BBAN>

<bws:BBAN description="Account" index="2">00006555</bws:BBAN>

<bws:dataAccessKey>Data access key</bws:dataAccessKey>

</eih:BWValidateIBANResponse>

</SOAP-ENV:Body>