---
title: "List banks available to connect"
method: GET
path: "/bank/providers"
tags: ["Bank Connections"]
---

# List banks available to connect

`GET /bank/providers`

Returns the directory of banks (providers) registered on SIX bLink. Use this to build a bank picker: take the `providerId` of the bank the user selects and pass it to `POST /bank/connect` to start the consent flow.

Each item has `providerId` (the id to connect with), `name`, `abbreviation`, `url`, and `logo`. `logo` is `null` unless `?logos=true` is set, in which case it is a `data:` URI (SVG) suitable for direct display.

## Query parameters

- `logos` boolean

## Response `200`

List of connectable banks

- SuccessEnvelope
  - `data` unknown
  - `success` true, required

## Other responses

- `400` — Bad Request
- `401` — Invalid API key
- `500` — Internal Server Error
- `502` — bLink directory unavailable

---

[API](https://skmtc.dev/vocal/apis/magic-heidi-invoicing-software-api.md) · [All operations](https://skmtc.dev/vocal/apis/magic-heidi-invoicing-software-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vocal/magic-heidi-invoicing-software-api/revisions/591ae048f0a0/schema)