/Institutions/RoutingNumber

Get Institution by Routing Number

curl --request GET \
  --url https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/Institutions/RoutingNumber/{routingNumber}

const options = {method: 'GET'};

fetch('https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/Institutions/RoutingNumber/{routingNumber}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/Institutions/RoutingNumber/{routingNumber}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/Institutions/RoutingNumber/{routingNumber}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/Institutions/RoutingNumber/{routingNumber}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "Id": 20,
  "Localizations": [
    {
      "Language": "en",
      "Name": "Chase Bank",
      "Urls": [
        {
          "Type": "Main",
          "Url": "https://www.chase.com/"
        }
      ]
    }
  ],
  "Status": "Enabled",
  "Country": "US",
  "RoutingNumbers": [
    "071000770",
    "072413201",
    "065000029",
    "071901141",
    "111100022",
    "043202409",
    "311972788",
    "121143257",
    "021000021",
    "322271627"
  ]
}

{
  "HttpStatusCode": 404,
  "Message": "No institution was found with the Routing Number: 322271622"
}

GET

{customerId}

BankingServices

Institutions

RoutingNumber

{routingNumber}

Get Institution by Routing Number

curl --request GET \
  --url https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/Institutions/RoutingNumber/{routingNumber}

const options = {method: 'GET'};

fetch('https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/Institutions/RoutingNumber/{routingNumber}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/Institutions/RoutingNumber/{routingNumber}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/Institutions/RoutingNumber/{routingNumber}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/Institutions/RoutingNumber/{routingNumber}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "Id": 20,
  "Localizations": [
    {
      "Language": "en",
      "Name": "Chase Bank",
      "Urls": [
        {
          "Type": "Main",
          "Url": "https://www.chase.com/"
        }
      ]
    }
  ],
  "Status": "Enabled",
  "Country": "US",
  "RoutingNumbers": [
    "071000770",
    "072413201",
    "065000029",
    "071901141",
    "111100022",
    "043202409",
    "311972788",
    "121143257",
    "021000021",
    "322271627"
  ]
}

{
  "HttpStatusCode": 404,
  "Message": "No institution was found with the Routing Number: 322271622"
}

This endpoint returns the details of the institution corresponding to the routing number. This endpoint does not take any query parameters or body parameters.

Keep in mind

The routing numbers are present only for US institutions.

Path Parameters

customerId

string

default:43387ca6-0391-4c82-857d-70d95f087ecb

required

Unique GUID provided by Flinks.

routingNumber

string

required

Routing Number for the Institution details to be accessed.

Response

Success

integer

Unique identifier for the institution.

Localizations

object[]

Localized information for the institution.

Show child attributes

Status

string

Status of the institution.

Country

string

Country code.

RoutingNumbers

string[]

List of all routing numbers associated with the institution.

⌘I

API Reference

Auth

Connect

Enrich

Outbound

Pay

Upload

Utilities

Path Parameters

Response