List Institutions
List Institutions
Fetches a list of institutions, optionally filtered by name. Results are paginated.
URL
Request
curl --request GET \
--url 'https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=SOME_BOOLEAN_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE' \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN'
const options = {method: 'GET', headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}};
fetch('https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=SOME_BOOLEAN_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import requests
url = "https://api.moneykit.com/institutions"
querystring = {"name":"SOME_STRING_VALUE","featured":"SOME_BOOLEAN_VALUE","cursor":"SOME_STRING_VALUE","limit":"SOME_INTEGER_VALUE"}
headers = {"Authorization": "Bearer REPLACE_BEARER_TOKEN"}
response = requests.request("GET", url, headers=headers, params=querystring)
print(response.text)
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=SOME_BOOLEAN_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer REPLACE_BEARER_TOKEN")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=SOME_BOOLEAN_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer REPLACE_BEARER_TOKEN'
response = http.request(request)
puts response.read_body
import Foundation
let headers = ["Authorization": "Bearer REPLACE_BEARER_TOKEN"]
let request = NSMutableURLRequest(url: NSURL(string: "https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=SOME_BOOLEAN_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE")! as URL,
cachePolicy: .useProtocolCachePolicy,
timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers
let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? HTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()
Response
{
"institutions": [
{
"institution_id": "chase",
"institution_id_aliases": [
"bf6856b2-0460-4e1e-b837-8dd9c1338bc1",
"ins_56"
],
"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
: string
Cursor to fetch the next set of institutions. (You get this value from the previous call to /institutions
.)
featured
: boolean
If true, returns only featured institutions.
default: false
limit
: integer
A limit on the number of institutions to be returned.
default: 50
name
: string
If provided, returns only institutions containing this name (wholly or as a prefix).
example: Chase
Responses
200
Successful Response
institutions
: array
The list of institutions for this page.
cursors
: object
Pagination information.
429
Rate limit exceeded.
error_code
: string
api_error.rate_limit_exceeded
default: "api_error.rate_limit_exceeded"
Allowed values:
"api_error.rate_limit_exceeded"
error_message
: string
Error message
default: "Rate limit exceeded"
documentation_url
: string
Request
curl --request GET \
--url 'https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=SOME_BOOLEAN_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE' \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN'
const options = {method: 'GET', headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}};
fetch('https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=SOME_BOOLEAN_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import requests
url = "https://api.moneykit.com/institutions"
querystring = {"name":"SOME_STRING_VALUE","featured":"SOME_BOOLEAN_VALUE","cursor":"SOME_STRING_VALUE","limit":"SOME_INTEGER_VALUE"}
headers = {"Authorization": "Bearer REPLACE_BEARER_TOKEN"}
response = requests.request("GET", url, headers=headers, params=querystring)
print(response.text)
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=SOME_BOOLEAN_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer REPLACE_BEARER_TOKEN")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=SOME_BOOLEAN_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer REPLACE_BEARER_TOKEN'
response = http.request(request)
puts response.read_body
import Foundation
let headers = ["Authorization": "Bearer REPLACE_BEARER_TOKEN"]
let request = NSMutableURLRequest(url: NSURL(string: "https://api.moneykit.com/institutions?name=SOME_STRING_VALUE&featured=SOME_BOOLEAN_VALUE&cursor=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE")! as URL,
cachePolicy: .useProtocolCachePolicy,
timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers
let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? HTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()
Response
{
"institutions": [
{
"institution_id": "chase",
"institution_id_aliases": [
"bf6856b2-0460-4e1e-b837-8dd9c1338bc1",
"ins_56"
],
"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
}