> ## Documentation Index > Fetch the complete documentation index at: https://docs.quidkey.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. > 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. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/banks/top openapi: 3.1.0 info: title: Quidkey API version: 1.0.0 description: API documentation for Quidkey Core Services servers: - url: https://core.quidkey.com description: Production security: [] paths: /api/v1/banks/top: get: tags: - Banks summary: >- 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. description: >- 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. parameters: - name: country in: query required: true schema: description: The market / country code (ISO 3166-1 alpha-2) examples: - GB type: string description: The market / country code (ISO 3166-1 alpha-2) - name: currency in: query required: false schema: description: Optional currency filter (ISO 4217) examples: - GBP type: string description: Optional currency filter (ISO 4217) - name: limit in: query required: false schema: minimum: 1 maximum: 50 description: Maximum number of banks to return examples: - 3 type: integer description: Maximum number of banks to return responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/bank_TopBanksResponse' example: success: true data: banks: - id: 123e4567-e89b-12d3-a456-426614174001 name: Santander market: GB currency: GBP displayName: Santander logoUrl: https://example.com/logo.png websiteUrl: https://www.santander.co.uk topInMarket: true '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/shared_Error400' example: success: false error: message: Invalid input provided '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/shared_Error401' example: success: false error: message: Invalid input provided components: schemas: bank_TopBanksResponse: type: object required: - success - data properties: success: description: Indicates if the request was successful examples: - true type: boolean data: additionalProperties: false type: object required: - banks properties: banks: type: array items: title: Bank description: A financial institution additionalProperties: false type: object properties: id: format: uuid description: The unique identifier of the bank examples: - 123e4567-e89b-12d3-a456-426614174001 type: string name: description: The name of the bank examples: - Santander type: string market: pattern: ^[A-Za-z]{2}$ minLength: 2 maxLength: 2 description: The market of the bank examples: - GB - US - FR - DE type: string currency: pattern: ^[A-Za-z]{3}$ minLength: 3 maxLength: 3 description: The currency supported by the bank examples: - GBP - USD - EUR - JPY type: string displayName: description: The display name of the bank examples: - Santander type: string logoUrl: description: >- 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. examples: - https://example.com/logo.png - https://img.logo.dev/chase.com?token=... type: string websiteUrl: description: >- The bank's website URL (the logos.dev fallback source for logoUrl). examples: - https://www.santander.co.uk type: string topInMarket: description: Indicates if the bank is top in the market examples: - true type: boolean shared_Error400: title: Bad Request Error description: 400 Bad Request Error Response type: object required: - success - error properties: success: description: Always false for error responses examples: - false const: false type: boolean error: type: object required: - code - message properties: code: allOf: - description: Error code for the specific error type examples: - INVALID_INPUT type: string - description: Error code for the specific error type examples: - VALIDATION_ERROR type: string message: description: Human-readable error message examples: - Invalid input provided type: string metadata: additionalProperties: true description: >- Additional error context. For VALIDATION_ERROR, includes a per-field `errors` array. type: object properties: errors: type: array items: type: object required: - field - message properties: field: type: string message: type: string shared_Error401: title: Unauthorized Error description: 401 Unauthorized Error Response type: object required: - success - error properties: success: description: Always false for error responses examples: - false const: false type: boolean error: type: object required: - code - message properties: code: allOf: - description: Error code for the specific error type examples: - INVALID_INPUT type: string - const: UNAUTHORIZED type: string message: description: Human-readable error message examples: - Invalid input provided type: string ````