---
title: "Check if a bank is supported by xs2a"
method: GET
path: "/bankcodes"
tags: ["Bankcodes API"]
---

# Check if a bank is supported by xs2a

`GET /bankcodes`

You will receive information about the selected bank. The field  `xs2a_supported` can be used to determine whether or not you should offer  XS2A products to your customer.

## Query parameters

- `bank_code` string
- `country_id` 'DE' | 'AT' | 'CH' — The 2-letter country code
- `bic` string
- `per_page` integer
- `page` integer
- `q` string

## Response `200`

Request successfully processed

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