---
title: "List Convenios"
method: GET
path: "/v1/banking/bank_accounts/{bank_account_id}/convenios"
tags: ["Convenio"]
---

# List Convenios

`GET /v1/banking/bank_accounts/{bank_account_id}/convenios`

## Request

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

Returns every payment agreement ("convenio") configured on a bank account,
ordered by `codigo`. Readable by any member of the company that owns the
account. This endpoint is **not** paginated — it returns the full list.

## Path parameters

- `bank_account_id` string, required

## Parameters

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

## Response `200`

List of convenios for the account.

- object[]
  - `id` string, uuid, required
  - `bank_account_id` string, uuid, required
  - `codigo` string, required: Convenio code as registered at the bank.
  - `descripcion` string, nullable
  - `habilitado_servibanca` boolean
  - `minimo_dias_pago` integer
  - `pensiones` boolean
  - `default` boolean: Whether this is the account's default convenio (at most one per account).
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Unauthorized — you are not a member of the account's company.
- `404`: The bank account was not found or is not accessible to you.

---

[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/ff1aeb3fda8b?raw)