---
title: "Retrieve banks for a specific market. Without query params returns the default list for the market. With `q` performs a substring match on bank name; `provider` further scopes to a provider configuration; `limit` caps results (default 20, max 50)."
method: GET
path: "/api/v1/banks/{market}"
tags: ["Banks"]
---

# Retrieve banks for a specific market. Without query params returns the default list for the market. With `q` performs a substring match on bank name; `provider` further scopes to a provider configuration; `limit` caps results (default 20, max 50).

`GET /api/v1/banks/{market}`

Retrieve banks for a specific market. Without query params returns the default list for the market. With `q` performs a substring match on bank name; `provider` further scopes to a provider configuration; `limit` caps results (default 20, max 50).

## Path parameters

- `market` string, required — The market code (e.g., GB, DE, US)

## Query parameters

- `q` string — Case-insensitive substring match on bank name
- `provider` union — Restrict results to banks tied to this payment provider. Account-info providers (e.g. Flinks) are addressed via the payment provider that routes through them (e.g. straddle / straddle_sandbox).
  - 'tink'
  - 'fumopay'
  - 'fumopay_sandbox'
  - 'sandbox'
  - 'straddle'
  - 'straddle_sandbox'
- `limit` integer — Maximum number of results (default 20)

## Response `200`

Success

- object[]
  - `success` boolean, required — Indicates if the request was successful
  - `data` object, required — A financial institution
    - `id` string, uuid — The unique identifier of the bank
    - `name` string — The name of the bank
    - `market` string — The market of the bank
    - `currency` string — The currency supported by the bank
    - `displayName` string — The display name of the bank
    - `logoUrl` string — Displayable logo URL. Prefers the bank's native logo; falls back to a logos.dev URL derived from websiteUrl. Empty string when neither is available.
    - `websiteUrl` string — The bank's website URL (the logos.dev fallback source for logoUrl).
    - `topInMarket` boolean — Indicates if the bank is top in the market

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)