List Bank Accounts
Changed onReturns 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
Request
- Base URLhttps://api.cardda.com
- AuthHTTP bearer
Query parameters
Starting index for pagination (0-based)
Ending index for pagination (exclusive)
Sort order (ASC or DESC)
Field to sort by
Filter by bank account UUID. Use id={"$in":["...","..."]} for batch lookups — the second-most-common shape in production traffic after holder_id.
Filter by account number (exact match)
Filter by RUT of the account holder. This is typically your company's RUT. Format: Include only numbers and verification digit (e.g., 771234568)
Filter by bank identifier
Filter by account type. corriente / vista / ahorro are the Chilean types, clabe is Mexico (STP) and yape is Peru (BCP). A bare value is an exact match.
Filter by holder (Person) UUID
Parameters
Response
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
Example response
[
{
"bank_id": "cl_banco_de_chile",
"type": "Banking::Cl::BancoDeChile::Account",
"number": "0011223344",
"rut": "77989372K",
"email": "pagos@cardda.com",
"name": "pagos cardda",
"bank_errors": [
{
"banking_entity_type": "Banking::BankEntity"
}
]
}
]Changes
- info
endpoint added
- info