List Institutions

List Institutions

Fetches a list of institutions, optionally filtered by name. Results are paginated.

URL

GET
/institutions
Request
curl --request GET \
--url 'https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=true&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE' \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'X-Client-Id: SOME_STRING_VALUE' \
--header 'X-Client-Secret: SOME_STRING_VALUE'
fetch("https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=true&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE", {
"method": "GET",
"headers": {
"Authorization": "Bearer REPLACE_BEARER_TOKEN",
"X-Client-Id": "SOME_STRING_VALUE",
"X-Client-Secret": "SOME_STRING_VALUE"
}
})
.then(response => response.json())
.then(data => console.log(data));
import requests

url = "https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=true&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE"
headers = {
'Authorization': 'Bearer REPLACE_BEARER_TOKEN',
'X-Client-Id': 'SOME_STRING_VALUE',
'X-Client-Secret': 'SOME_STRING_VALUE'
}

response = requests.get(url, headers=headers)
print(response.json())
package main

import (
"fmt"
"net/http"
)

func main() {
req, _ := http.NewRequest("GET", "https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=true&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE", nil)
req.Header.Add("Authorization", "Bearer REPLACE_BEARER_TOKEN")
req.Header.Add("X-Client-Id", "SOME_STRING_VALUE")
req.Header.Add("X-Client-Secret", "SOME_STRING_VALUE")

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

fmt.Println(res)
}
require 'net/http'
require 'json'

uri = URI('https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=true&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer REPLACE_BEARER_TOKEN'
request['X-Client-Id'] = 'SOME_STRING_VALUE'
request['X-Client-Secret'] = 'SOME_STRING_VALUE'

response = http.request(request)
puts response.body
import Foundation

let url = URL(string: "https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=true&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE")!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer REPLACE_BEARER_TOKEN", forHTTPHeaderField: "Authorization")
request.setValue("SOME_STRING_VALUE", forHTTPHeaderField: "X-Client-Id")
request.setValue("SOME_STRING_VALUE", forHTTPHeaderField: "X-Client-Secret")

let task = URLSession.shared.dataTask(with: request) { data, response, error in
guard let data = data else { return }
print(String(data: data, encoding: .utf8)!)
}
task.resume()
Response
{
"institutions": [
{
"institution_id": "chase",
"institution_id_aliases": "bf6856b2-0460-4e1e-b837-8dd9c1338bc1",
"name": "Chase",
"country": "US",
"domain": "chase.com",
"color": "#0A89FF",
"color_dark": "#0A89FF",
"is_featured": true
}
],
"cursors": {
"next": "c2FtcGxlIGN1cnNvcg=="
}
}
{
"error_code": "api_error.auth.expired_access_token",
"error_message": "Access token expired",
"documentation_url": string
}
{
"error_code": "api_error.rate_limit_exceeded",
"error_message": "Rate limit exceeded",
"documentation_url": string
}

cursor

Cursor to fetch the next set of institutions. (You get this value from the previous call to /institutions.)

limit

: integer

A limit on the number of institutions to be returned.

default: 50

name

If provided, returns only institutions containing this name (wholly or as a prefix).

example: Chase

X-Client-Id

: string

Your client ID.

example: live_dcc75c42eb6122127356

X-Client-Secret

: string

Your client secret

example: vzPznCv3kT7fHsAr6y3jk38d

Responses

200

Successful Response

institutions

: array

The list of institutions for this page.

cursors

: object

Pagination information.

429

Rate limit exceeded.

error_code

: string

default: "api_error.rate_limit_exceeded"

error_message

: string

Error message

default: "Rate limit exceeded"

documentation_url