---
title: "List Bank Accounts"
method: GET
path: "/v1/banking/bank_accounts"
tags: ["Bank account"]
---

# List Bank Accounts

`GET /v1/banking/bank_accounts`

## Request

- Base URL: `https://api.cardda.com`
- URL: `https://api.cardda.com/v1/banking/bank_accounts`
- Auth: HTTP bearer

Returns a paginated list of bank accounts that the current user has access to through their bank keys.

## Common Use Cases

### Finding Your Company's Bank Account (for sender_id)
To find your company's bank account for making payments:
```
GET /v1/banking/bank_accounts?rut=771234568
```
Where `771234568` is your company's RUT.

### Filtering by Account Number
To find a specific account by number:
```
GET /v1/banking/bank_accounts?number=987654321
```

### Filtering by Bank
To list all accounts from a specific bank:
```
GET /v1/banking/bank_accounts?bank_id=cl_banco_santander_chile
```

### Pagination
Use `_start` and `_end` parameters to control pagination:
```
GET /v1/banking/bank_accounts?_start=0&_end=10
```

## Important Notes
- You can only see accounts you have authorization to operate through bank keys
- The `id` field in the response is what you'll use as `sender_id` when creating transactions
- Account balance is updated when transactions are synchronized

## Bank IDs Reference
Common Chilean bank identifiers:
- `cl_banco_de_chile` - Banco de Chile
- `cl_banco_bci` - BCI
- `cl_banco_santander_chile` - Santander Chile
- `cl_banco_itau` - Itaú
- `cl_banco_bice` - BICE
- `cl_banco_scotiabank` - Scotiabank
- `cl_banco_security` - Banco Security
- `cl_banco_estado` - BancoEstado

## Query parameters

- `_start` integer
- `_end` integer
- `_order` 'ASC' | 'DESC'
- `_field` string
- `id` string
- `number` string
- `rut` string
- `bank_id` string
- `account_type` 'corriente' | 'vista' | 'ahorro' | 'clabe' | 'yape'
- `holder_id` string, uuid

## Parameters

- `#/paths/~1v1~1banking~1bank_keys/get/parameters/0` (unresolved $ref)

## Response `200`

Paginated list of bank accounts. The response includes metadata headers:
- `Content-Range`: Indicates the range of items returned (e.g., `0-9/45`)
- `X-Total-Count`: Total number of accounts available

- BankAccount[]
  - `id` string, uuid, required
  - `balance` integer, nullable: The account balance, in the currency's minor unit, as Cardda read it the last time it synced the account with the bank. **This field is not included in every response that uses this schema.** Only `GET /v1/banking/bank_accounts`, `GET /v1/banking/bank_accounts/{bank_account_id}` and the payroll-level `sender` (`Bank_payroll.sender`) of each row in `GET /v1/banking/bank_payrolls/` (the account the payroll is paid from, not the `sender` of its transactions) return it, and only if the company that holds the account turned on **"Mostrar el saldo y las inversiones"** in its company settings (Configuración de la empresa). When that setting is off, the `balance` key is omitted entirely (it is not sent as `null`, which in this API means something else: "we have never read this account"). Everywhere else this schema is reused — `Bank_transaction.sender` and `Bank_key_filtered.accounts` — the key is always omitted, regardless of that setting: there the account identifies where the payment comes from, it does not report its funds. An integration that needs the balance should read it from `GET /v1/banking/bank_accounts`.
  - `holder_id` string, uuid, nullable: UUID of the Person (company or counterpart) that owns the account.
  - `bank_id` string: Bank identifier, e.g. `cl_banco_de_chile`, `mx_stp`, `us_mercury`.
  - `type` string: STI subclass, bank-specific (e.g. `Banking::Cl::BancoDeChile::Account`).
  - `number` string, required
  - `rut` string, required
  - `email` string
  - `name` string
  - `account_type` 'corriente' | 'vista' | 'ahorro' | 'clabe' | 'yape', nullable: Chilean account types are the following: > * 'corriente' > * 'vista' > * 'ahorro' Mexican account types are the following: > * 'clabe' Peruvian account types are the following: > * 'yape' For more details check the [guide](https://docs.cardda.com/docs).
  - `bank_errors` object[]
    - `id` string, uuid
    - `banking_entity_id` string, uuid
    - `banking_entity_type` string
    - `error_code` 'auth/wrong-credentials' | 'auth/invalid-body' | 'recipient/create/invalid-body' | 'recipient/create/unknown-bank-name' | 'recipient/create/unknown-account-type' | 'recipient/get/unknown-bank-name' | 'recipient/get/unknown-account-type' | 'recipient/authorization/not-found' | 'recipient/authorization/invalid-data' | 'transaction/enqueue/invalid-body' | 'transaction/enqueue/first-transaction-max-amount' | 'transaction/enqueue/transaction-daily-max-amount' | 'transaction/enqueue/recipient-not-registered' | 'transaction/enqueue/sender-account-not-fund' | 'transaction/enqueue/recipient-collision' | 'transaction/enqueue/sender-collision' | 'transaction/dequeue/invalid-body' | 'transaction/dequeue/not-found' | 'transaction/dequeue/dequeue-all-unsuccessful' | 'transaction/dequeue/no-queued-transactions' | 'transaction/get/unknown-status' | 'transaction/get/unknown-date-format' | 'transaction/get/invalid-body' | 'transaction/authorization/invalid-body' | 'transaction/authorization/wrong-token' | 'transaction/authorization/invalid-method' | 'transaction/authorization/no-queued-transactions' | 'transaction/authorization/insufficient-funds' | 'transaction/authorization/account-token-blocked' | 'account/get/not-found' | 'account/common/blocked-auth-devices' | 'account/common/temporary-blocked' | 'page/failed-to-load-components' | 'page/recipient-save-unsuccessful' | 'page/transaction-enqueue-unsuccessful' | 'page/transaction-authorization-unsuccessful' | 'request/expired-cookies', nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Unauthorized — missing or invalid bearer token, `company-id` header not set, or the caller is not authorized for the requested scope. Pundit authorization failures return `401` with an empty body (no `403`).

## Changes

- **2026-11-03** `785332193a09`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cardda/apis/banking-api/changes/v1/banking/bank_accounts/get.md)

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) - [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cardda/apis/banking-api/revisions/785332193a09?raw)
