DESCRIPTION
This is a supplementary call to calls 1.01 and 1.02, where the search has returned multiple branches. Ā This call allows you to retrieve additional details for a single branch. Ā This will allow the user to retrieve additional details for branches that they have already validated like the head office and payment office details. Ā This call uses the freeToken and so you will not be charged to retrieve this information.
Once you have validated the bank details you may want to retrieve additional details for the branch that are not available until you have selected a single branch. Ā The call only requires the user to enter a bank token (retrieved from call 1.01 or 1.02) and a freeToken (retrieved from call 1.01 or 1.02).
URL STRUCTURE
https://validate.bankersalmanac.com/validate-api/rest/convert/1.3
METHOD
GET command, in “application/json” format
REQUEST
The request will be allow you to validate the data entered by the user. There are 2Ā fields to enter data into for the search, these are below;
| FIELD NAME | DESCRIPTION | FORMAT | MANDATORY |
| freeToken | Free security token retrieved with a validation call. | Alphanumeric | Mandatory |
| bankToken | Ā Token that defined the bank branch from a validation call. | Alphanumeric | Mandatory |
RESPONSE
The response will give either give the branch details or will error. If the response is positive then we will respond with the details for the branch that was search for. This will include the branch details including the banks codes, itās SEPA status and if each branch has SSI details, Contact details and Payment Service details available and a bank token. The SSIs, contact details and payment service details can be retrieved using the calls 2.2, 4.2 and 2.1 respectively. If you require the IBAN BIC and the head office details then these can be retrieved using the bankToken in call 1.3.This will call will retrieve the branch details.