---
title: "List Banks"
method: GET
path: "/v1/banking/banks"
tags: ["Bank"]
---

# List Banks

`GET /v1/banking/banks`

Returns the list of banks Cardda supports. This is **global reference data**:
it is not scoped to a company, returns the same list to every caller, and
**requires no authentication** — this endpoint accepts requests with no
`Authorization` bearer token and no `company-id` header.

Use each bank's `id` (a stable slug such as `cl_banco_estado`) as the `bank_id`
value when creating bank recipients, reading balances, or filtering by bank.

Results are paginated and support the standard `_start`/`_end`/`_order`/`_field`
window, and the response carries `X-Total-Count` / `Content-Range` headers.

## Query parameters

- `_start` integer
- `_end` integer
- `_order` 'asc' | 'desc'
- `_field` string
- `id` string
- `name` string

## Response `200`

Paginated list of supported banks.

- object[]
  - `id` string, required — Stable bank identifier (slug), NOT a UUID. Chilean banks are prefixed with `cl_`, Mexican with `mx_`, Peruvian with `pe_`.
  - `name` string, required
  - `image_url` string, nullable — URL of the bank's logo. May be `null`.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400` — Bad Request — the query used an unknown filter field or malformed filter DSL.

---

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