---
title: "Update the status of top banks for a specific market"
method: PUT
path: "/api/v1/admin/banks/top/{market}"
tags: ["Banks", "Admin"]
---

# Update the status of top banks for a specific market

`PUT /api/v1/admin/banks/top/{market}`

## Request

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

Update the status of top banks for a specific market

## Path parameters

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

## Request body

- object
  - `bankNames` string[], required
  - `topInMarket` boolean, required: Whether these banks should be marked as top in the market

## 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/admin/banks/top/:market/put.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)