---
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}`

## Request

- Base URL: `https://core.quidkey.com`
- URL: `https://core.quidkey.com/api/v1/banks/{market}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/banqzinc/apis/quidkey-api/docs/api/v1/banks/:market/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-06-17** `b372e7d5563d`: 2 breaking, 1 warning, 8 info
  - the `error/code` response's property type changed from `string` to no type for status `400`
  - the `items/data/logoUrl` response's property format changed from `uri` to no format for status `200`
  - removed the optional property `error/errors` from the response with the `400` status
  - added the new optional `query` request parameter `limit`
  - …7 more
- **2025-11-05** `6637b341d86d`: 1 info
  - endpoint added
- **2025-11-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/banks/:market/get.md)

---

[API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) - [All operations](https://skmtc.dev/banqzinc/apis/quidkey-api/llms.txt) - [OpenAPI document](https://skmtc.dev/banqzinc/apis/quidkey-api/revisions/f86d2bdbcb08?raw)