curl --request POST \
--url https://api.onswitch.xyz/institution/lookup \
--header 'Content-Type: application/json' \
--header 'x-service-key: <api-key>' \
--data '
{
"country": "NG",
"bank_code": "058",
"channel": "BANK"
}
'{
"success": true,
"message": "Institution lookup successful",
"timestamp": "2024-01-01T00:00:00.000Z",
"data": {
"code": "058",
"name": "Guaranty Trust Bank",
"country": "NG"
}
}Resolve bank or payment institution details from country-specific identifiers (e.g. domestic bank code, routing number, or SWIFT/BIC). Required fields depend on the country and rail.
curl --request POST \
--url https://api.onswitch.xyz/institution/lookup \
--header 'Content-Type: application/json' \
--header 'x-service-key: <api-key>' \
--data '
{
"country": "NG",
"bank_code": "058",
"channel": "BANK"
}
'{
"success": true,
"message": "Institution lookup successful",
"timestamp": "2024-01-01T00:00:00.000Z",
"data": {
"code": "058",
"name": "Guaranty Trust Bank",
"country": "NG"
}
}Service key for API authentication
ISO 3166-1 alpha-2 country code
"NG"
Domestic bank or institution code (e.g. NIBSS bank code)
"058"
Bank routing number (e.g. US ACH/Fedwire)
SWIFT BIC where applicable
Optional account number for supported account verification flows
Transfer channel context for the lookup
BANK, BLOCKCHAIN, SWIFT, SEPA, SEPA_EUR, WIRE, ACH, DOMESTIC_GBP, MOBILEMONEY, ALIPAY, WECHATPAY