---
title: "Get a paginated list of all bankcodes for a query string"
method: GET
path: "/bankcodes/autocomplete"
tags: ["Bankcodes API"]
---

# Get a paginated list of all bankcodes for a query string

`GET /bankcodes/autocomplete`

For a paginated result of bankcodes based on a query string, send a get request to this endpoint.

## Query parameters

- `q` string, required
- `country_id` 'DE' | 'AT' | 'CH' — The 2-letter country code
- `per_page` integer
- `page` integer
- `product` 'xs2a_verify' | 'xs2a_risk' | 'xs2a_pay' | 'xs2a_api' — The name of the xs2a product.

## Response `200`

Request successfully processed

- BankObjectList
  - `total` integer — Total number of results.
  - `per_page` integer — Number of objects per page
  - `current_page` integer — Current page.
  - `last_page` integer — Last page, usually the total of available pages.
  - `from` integer — Showing results from index element.
  - `to` integer — Showing results to index element.
  - `data` BankObject[]
    - `bank_code` string — bank code of the bank
    - `bic` string — BIC of the bank
    - `name` string — Name of the bank
    - `short_name` string — Abbreviated bank name
    - `zipcode` string — National ZIP code of the bank
    - `city` string — City
    - `country_id` 'DE' | 'AT' | 'CH' — The 2-letter country code
    - `testmode` string — '1', if this bank is a testbank
    - `xs2a_products` Product[] — array of xs2a products supported
    - `xs2a_supported` boolean — true, if this bank is supported by XS2A

## Other responses

- `401` — Authentication failed API key missing or not valid
- `403` — Forbidden Access blocked
- `404` — Product not enabled or Not found The requested object does not exist on the server
- `500` — An internal server problem occurred

---

[API](https://skmtc.dev/xs2a/apis/xs2a-api.md) · [All operations](https://skmtc.dev/xs2a/apis/xs2a-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xs2a/xs2a-api/revisions/ae5fbc5feee3/schema)