---
title: "Retrieve the top banks for a specific market"
method: GET
path: "/api/v1/banks/top/{market}"
tags: ["Banks"]
---

# Retrieve the top banks for a specific market

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

## Request

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

Retrieve the top banks for a specific market

## Path parameters

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

## Response `200`

Success

- BankListResponse
  - `success` boolean, required: Indicates if the request was successful
  - `data` object[], required
    - `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, 4 info
  - the response's body type changed from `array` to `object` for status `200`
  - the `error/code` response's property type changed from `string` to no type for status `400`
  - removed the optional property `error/errors` from the response with the `400` status
  - added the optional property `error/metadata` to the response with the `400` status
  - …3 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/top/: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)