Get bank details via routing code

Get banking details by routing code and routing value.

Definition

URL

POST https://api-test.instarem.com:4803/api/v1/routing-code/search

Headers Parameters

Parameter	Description	Type	Required
Authorization	Authentication Token.	String	Yes
Content-Type	The Content-Type entity header is used to indicate the media type of the resource. Expected value is application/json.	String	Yes
X-CLIENT-ID	Unique id for client generated by Nium, Required only in case of partner based model (E.g. 593feb7c7c52bb2357b2df6c).	String	No

Example Request

Bash

curl --location --request POST 'https://api-test.instarem.com:4803/api/v1/routing-code/search' \\
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MjEzMjc4NzYsImRhdGEiOnsiY2xpZW50IjoiNTkyZDFlYjA2NzJmYjI0NDAwYmQ2OWNmIiwic3ViIjoiNWRiNTU0ZDc5ZjExZDAwMDA4ZGZmZjhiIn0sImlhdCI6MTYyMTI0MTQ3Nn0.Ou9X2erx1eHx32PG_upNdGm9-59UpXW1XbSaSIJ4uWo' \\
--header 'Content-Type: application/json' \\
--data-raw '{
    "country_code": "ES",
    "search_key": "SWIFT",
    "search_value": "AYGBESMM",
    "currency_code": "EUR",
    "payout_method": "LOCAL",
    "routing_code_type": "SWIFT"
}'

Javascript

var data = JSON.stringify({
    "country_code": "ES",
    "search_key": "SWIFT",
    "search_value": "AYGBESMM",
    "currency_code": "EUR",
    "payout_method": "LOCAL",
    "routing_code_type": "SWIFT"
});
var xhr = new XMLHttpRequest();
xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});
xhr.open("post", "https://api-test.instarem.com:4803/api/v1/routing-code/search");
xhr.setRequestHeader("authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE0OTgxMzQ4OTQsImRhdGEiOnsic3ViIjoiNTk0MjNmMzZjZWEyMTQ2OTI2ODczOWE1IiwiY2xpZW50IjoiNTk0MjNmMzZjZWEyMTQ2OTI2ODczOWExIn0sImlhdCI6MTQ5ODA0ODQ5NH0.pevwSDpk-JDNtVIpqFu_m0Xu1UnDVumrAYStcrxf8sM");
xhr.setRequestHeader("content-type", "application/json");
xhr.send(data);

C#

var client = new RestClient("https://api-test.instarem.com:4803/api/v1/routing-code/search");
var request = new RestRequest(Method.POST);
request.AddHeader("authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE0OTgxMzQ4OTQsImRhdGEiOnsic3ViIjoiNTk0MjNmMzZjZWEyMTQ2OTI2ODczOWE1IiwiY2xpZW50IjoiNTk0MjNmMzZjZWEyMTQ2OTI2ODczOWExIn0sImlhdCI6MTQ5ODA0ODQ5NH0.pevwSDpk-JDNtVIpqFu_m0Xu1UnDVumrAYStcrxf8sM");
request.AddHeader("content-type", "application/json");
request.AddParameter("application/json", @"{
    ""country_code"": ""ES"",
    ""search_key"": ""SWIFT"",
    ""search_value"": ""AYGBESMM"",
    ""currency_code"": ""EUR"",
    ""payout_method"": ""LOCAL"",
    ""routing_code_type"": ""SWIFT""
}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

Body Parameters

Parameter	Description	Type	Required
country_code	2 letter ISO country code (e.g. ES)	String	Yes
search_key	Search key (e.g. SWIFT)	String	Yes
search_value	Search value (e.g. AYGBESMM)	String	Yes
currency_code	Three letter ISO currency code (e.g. EUR)	String	No
payout_method	Payout method (e.g. LOCAL)	String	No
routing_code_type	Routing code type (e.g. SWIFT)	String	Yes

Example Response

[
    {
        "swift": "AYGBESMM",
        "bank_name": "A&G BANCA PRIVADA S.A.U.",
        "country_code": "ES",
        "payout_method": "LOCAL"
    }
]

Response Parameters

Parameter	Description	Type
swift	Swift value.	String
bank_name	Bank name.	String
country_code	Country code.	String
payout_method	Payout method.	String