---
title: "Retrieve the curated top banks for a market. `country` selects the market; optional `currency` filters further; `limit` caps the result count. Public and cacheable at the market level."
method: GET
path: "/api/v1/banks/top"
tags: ["Banks"]
---

# Retrieve the curated top banks for a market. `country` selects the market; optional `currency` filters further; `limit` caps the result count. Public and cacheable at the market level.

`GET /api/v1/banks/top`

Retrieve the curated top banks for a market. `country` selects the market; optional `currency` filters further; `limit` caps the result count. Public and cacheable at the market level.

## Query parameters

- `country` string, required — The market / country code (ISO 3166-1 alpha-2)
- `currency` string — Optional currency filter (ISO 4217)
- `limit` integer — Maximum number of banks to return

## Response `200`

Success

- BankTopBanksResponse
  - `success` boolean, required — Indicates if the request was successful
  - `data` object, required
    - `banks` 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

---

[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)