# Accounts

Una **cuenta** es la representación de una cuenta bancaria dentro de una institución financiera. Un usuario puede tener una o más cuentas en una institución.

Por ejemplo, un usuario (o enlace) puede tener una cuenta corriente, varias tarjetas de crédito y una cuenta de préstamo.

Consultar la información de la cuenta de un usuario es útil ya que puedes obtener información sobre:

- qué tipos de cuentas tiene el usuario.
- el saldo de cada cuenta (ahorros, cuenta corriente, tarjeta de crédito, préstamo, etc.).
- información detallada sobre sus gastos con tarjeta de crédito.
- la situación actual de cualquier préstamo que puedan tener.

## Listar cuentas

 - [GET /api/accounts/](https://developers.belvo.com/es/apis/belvoopenapispec/accounts/listaccounts.md): ## ▶️ Uso

Con el método List Accounts, puedes:

1. Listar cuentas relacionadas con un  específico (usando el parámetro de consulta ).
2. Obtener los detalles de un  específico (usando el parámetro de consulta ).
3.  Listar todas las cuentas relacionadas con tu cuenta de Belvo (sin usar ningún parámetro de consulta).

## 🔦 Filtrado de Respuestas

Consulta la lista de campos a continuación para ver por cuáles puedes filtrar tus respuestas. Para más información sobre cómo usar filtros, consulta nuestro artículo Filtrado de respuestas.

## 📖 Paginación

Este método devuelve una respuesta paginada (por defecto: 100 elementos por página). Puedes usar el parámetro de consulta  para aumentar el número de elementos devueltos hasta un máximo de 1000 elementos. Puedes usar el parámetro de consulta  para navegar a través de los resultados. Para más detalles sobre cómo navegar por las respuestas paginadas de Belvo, consulta nuestro artículo Consejos de Paginación.

## 🚨 Campos Obsoletos

Este recurso puede devolver campos obsoletos. En la documentación de la respuesta, puedes ver que un campo ha sido marcado como . Esto significa que este campo ya no es mantenido por el equipo de Belvo. Aún puedes recibir datos para este campo dependiendo de la institución, sin embargo, no deberías depender de este campo.

## Recuperar cuentas para un enlace

 - [POST /api/accounts/](https://developers.belvo.com/es/apis/belvoopenapispec/accounts/retrieveaccounts.md): Recuperar cuentas de un enlace existente.

{% admonition type="info" %}
  Este recurso puede devolver campos obsoletos. Por favor, consulte la documentación de la respuesta para más información.
{% /admonition %}

## Completar una solicitud de cuentas

 - [PATCH /api/accounts/](https://developers.belvo.com/es/apis/belvoopenapispec/accounts/patchaccounts.md): Se utiliza para reanudar una sesión de recuperación de Cuenta que se pausó porque la institución requirió un token MFA.

{% admonition type="info" %}
  Este recurso puede devolver campos obsoletos. Por favor, consulte la documentación de la respuesta para obtener más información.
{% /admonition %}

## Obtener los detalles de una cuenta

 - [GET /api/accounts/{id}/](https://developers.belvo.com/es/apis/belvoopenapispec/accounts/detailaccount.md): Obtener los detalles de una cuenta específica.

{% admonition type="info" %}
  Este recurso puede devolver campos obsoletos. Por favor, consulte la documentación de la respuesta para más información.
{% /admonition %}

## Eliminar una cuenta

 - [DELETE /api/accounts/{id}/](https://developers.belvo.com/es/apis/belvoopenapispec/accounts/destroyaccount.md): Eliminar una cuenta específica de tu cuenta de Belvo.

{% admonition type="danger" name="Rate Limited" %}
  Este endpoint tiene un límite de tasa. Solo puedes eliminar 5 elementos por minuto. Si excedes este límite, recibirás un código de estado .
{% /admonition %}

{% admonition type="info" %}
  Cuando eliminas una cuenta, todas las transacciones asociadas y la información del propietario para esa cuenta también se eliminan.
{% /admonition %}