All Sender and Recievers Correspondents

This call is designed to return the correspondent bank details required to make a payment for the payment details entered. This call does not return any details on the branch itself.  The call will validate the clients account number and bank code data and respond with only the correspondent details for the currency that the user entered.  The search criteria as below and also require the user to enter a valid ISO currency code.

1. BIC
2. National id
3. BIC and domestic account number
4. National id and domestic account number
5. Structured account number (BBAN, IBAN or CLABE).

The service returns the correspondnet details for both the sending and recieivng bank and the address of each of the correspondents for the reciever.

METHOD

GET command, in “application/json” format

https://validate.bankersalmanac.com/validate-api/rest/convert/2.3

REQUEST

The request parameters can be seen below

Field name	Field description	Mandatory or Optional	Sample data
originCountryCode	Originator ISO 2 digit country code	M	TR
originBIC	BIC of the originator	M	AKBKTRISXXX
originAcct	Account number of the originator	O
currencyCode	ISO 3 digit currency code	M	JPY
assetCategory	Cateogry of the payment type	M	COPA
countryCode	Beneficiary ISO 2 digit country code	M	US
nationalId	National id or BIC of the beneficiary	M	SMBCUS33
benAcct	Account number of the beneficiary	O
ref	Your refernce number	O
errorComment	No in use	O
token	Security token	M

RESPONSE

Field Name	Field Description	Sample
currencyCode	ISO 3 digit currency code	“JPY”,
originator	Label – Originator Bank Details	{
nm	Bank Name	“AKBANK T.A.S.”,
pstlAdr	Postal address	“SABANCI CENTER LEVENT 4, ISTANBUL, 34330, TURKEY”,
bic	Banks BIC	“AKBKTRISXXX”,
acct	Account number	“”,
codeDetails		{
codeName1	Code value 1 name	“BIC”,
codeValue1	Code value 1	“AKBKTRISXXX”,
codeName2	Code value 2 name	“CHIPS”,
codeValue2	Code value 2	“095893”,
codeName3	Code value 3 name	“BIC-4”,
codeValue3	Code value 3	“AKBK”,
codeName4	Code value 4 name	“Banka Kodu”,
codeValue4	Code value 4	“004699999”
},
ssiDetails	LABEL
assetCategory	Asset type of correspondent bank account	“ALL”,
corresBIC	Originator correspondent BIC	“SMBCJPJTXXX”,
corresAcct	Originator correspondent account number	“3088”
preferred	Is this the preferred correspondent	“”,
},
beneficiary	Label – Beneiciary  Bank Details	{
nm	Bank Name	“SUMITOMO MITSUI BANKING CORPORATION”,
pstlAdr	Postal address	“277 PARK AVENUE, NEW YORK, 10172, UNITED STATES OF AMERICA”,
nationalId	Bank national id	“SMBCUS33”,
bic	Banks BIC	“SMBCUS33XXX”,
acct	Account number	“”,
codeDetails		{
codeName1	Code value 1 name	“BIC”,
codeValue1	Code value 1	“SMBCUS33XXX”,
codeName2	Code value 2 name	“CHIPS”,
codeValue2	Code value 2	“013571”,
codeName3	Code value 3 name	“BIC-4”,
codeValue3	Code value 3	“SMBC”,
codeName4	Code value 4 name	“ABA”,
codeValue4	Code value 4	“026009674”
},
ssiDetails	LABEL
assetCategory	Asset type of correspondent bank account	“ALL”,
corresBIC	Beneficary correspondent BIC	“IRVTUS3NXXX”,
corresAcct	Beneficiary correspondent account number	“8900112026”,
intrmyBIC1	Beneficary intermdiary 1 BIC	“”,
intrmyAcct1	Beneficiary intermediary 1 account number	“”,
intrmyBIC2	Beneficary intermdiary 2 BIC	“”,
intrmyAcct2	Beneficiary intermediary 2 account number	“”,
institutionName	Bank Name	“THE BANK OF NEW YORK MELLON”,
city	Bank City	“NEW YORK,NY”,
countryName	Bank Country	“UNITED STATES OF AMERICA”,
countryCode	Bank ISO 2 digit country code	“US”,
natId	Domestic clearing code	“021000018”,
preferred	Is this the preferred correspondent	“”
},
recommendedAcct		“”,
recommendedBIC	Recommended beneficiary bic	“SMBCUS33XXX”,
status	Status code	“CAUTION”,
comment	Error code	“Check Asset category – Originator SSI was found but with incorrect asset category (07ro)”,
ref	Reference number	“20191206094912411”,
bic8	Was the BIC8 flag set?	“N”

SAMPLE

https://validate.bankersalmanac.com/validate-api/rest/convert/2.3?originBIC=bukbgb22&originAcct=12345678&currencyCode=USD&countryCode=tr&nationalId=TUBATRIS&benAcct=12345678&token=bQYljJ8WWVip7kjpDksnN4vngxB25Qcr1ipMM7O0FZyuQH7mtggkzisX9hjH98pN0LCRq8WWNcam0Iie&ref&bic8&assetCategory=ANYY