Toshl Developer

List institutions

Get all institutions.

GET /bank/institutions

Required scope:

Parameters

page
optional
integer

Page to display, used for pagination.

Minimum: >= 0
Default value: 0
per_page
optional
integer

Number of resource objects to return.

Minimum: >= 10
Maximum: =< 500
Default value: 200
country
optional
string

Limit institutions to country

Regex: [A-Z]{2}
search
optional
string

Search institutions
providers
optional
string

Comma separated list of providers

Possible values: plaid, toshl, saltedge, saltedge-partner
sort
optional
string

Sort instituions by.

Possible values: alpha, popular
Default value: popular
firstletter
optional
string

Filter institutions by first letter.

* denotes required field/parameter.

Request

$ curl https://api.toshl.com/bank/institutions \
  -H "Authorization: Bearer T9cE5asGnuyYCCqIZFoWjFHvNbvVqHjl"

Response

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "id": "42",
    "ext_id": "ins_10",
    "name": "American Express",
    "url": "https://www.americanexpress.com/",
    "logo": "https://api.toshl.com/bank/institutions/42/logo",
    "provider": "plaid"
  }
]