# Links

Un **Link** es un conjunto de credenciales asociadas al acceso de un usuario final a una **institución**. Necesitarás registrar un **Link** antes de acceder a la información de ese usuario final específico, como los detalles de cuenta o transacciones.

Recomendamos usar el Belvo Hosted Widget para gestionar el proceso de conexión.

## Enumerar enlaces

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

Con el método List Links, puedes:

1. Listar todos los enlaces relacionados con tu cuenta de Belvo (sin usar parámetros de consulta).
2. Obtener los detalles de un  específico (usando el parámetro de consulta ).

## 📖 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.

## 🔦 Filtrado de Respuestas

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

## Registrar un nuevo enlace

 - [POST /api/links/](https://developers.belvo.com/es/apis/belvoopenapispec/links/registerlink.md): ## ▶️ Uso

Registra un nuevo enlace (una conexión entre tu usuario y su institución) utilizando la API de Belvo.

> 👍 Recomendamos encarecidamente usar nuestro Connect Widget para manejar la creación de enlaces y las actualizaciones de estado de los enlaces.

Para facilitar las cosas, hemos incluido ejemplos personalizados para los enlaces que puedes crear para cada uno de nuestros productos. Simplemente haz clic en el tipo de enlace que deseas crear en la sección  a continuación.

## Completar una solicitud de enlaces

 - [PATCH /api/links/](https://developers.belvo.com/es/apis/belvoopenapispec/links/patchlinks.md): Se utiliza para reanudar una sesión de registro de Link que se pausó porque la institución requería un token MFA.

## Obtener los detalles de un enlace

 - [GET /api/links/{id}/](https://developers.belvo.com/es/apis/belvoopenapispec/links/detaillink.md): Obtén los detalles de un enlace específico.

## Modificar la recuperación de datos de un enlace

 - [PATCH /api/links/{id}/](https://developers.belvo.com/es/apis/belvoopenapispec/links/modifylinkdataretrieval.md): Modifique la configuración de recuperación de datos para un enlace específico. Actualmente puede:

  - Cambiar el modo de acceso de un enlace de  a  o de  a .
  - Modificar el período  para el enlace.
  - Modificar los recursos históricos que desea recuperar para el enlace ().

## Cambiando el  de un enlace

Cuando cambia un enlace de  a , al día siguiente se activa una actualización histórica de los recursos principales para el enlace (lo que resulta en que reciba webhooks de  para el enlace). Se le cobrará por estas actualizaciones históricas.

## Modificando 

Si solo modifica el período  para un enlace, esto no activará una actualización histórica. Para activar una actualización histórica para el enlace, debe cambiar el .

## Modificando 

Si solo modifica los  para un enlace, esto no activará una actualización histórica. Para activar una actualización histórica para el enlace, debe cambiar el .

## Actualizar las credenciales de un enlace

 - [PUT /api/links/{id}/](https://developers.belvo.com/es/apis/belvoopenapispec/links/updatelink.md): Actualiza las credenciales de un enlace específico. Si el enlace actualizado con éxito es recurrente, automáticamente activamos una actualización del enlace. Si encontramos datos nuevos, recibirás webhooks de actualización histórica.

> 👍 Usa nuestro Connect Widget
>
> Recomendamos usar nuestro Connect Widget para manejar la actualización de enlaces invalid o token_required.

## Eliminar un enlace

 - [DELETE /api/links/{id}/](https://developers.belvo.com/es/apis/belvoopenapispec/links/destroylink.md): Elimina un enlace específico y todos los datos asociados (por ejemplo: transacciones, cuentas, facturas, declaraciones de impuestos, empleos, etc.) de ese enlace de tu cuenta de Belvo. Esta acción es irreversible y no podrás recuperar los datos eliminados.

{% admonition type="success" name="Usa el encabezado X-Belvo-Request-Mode: async" %}
  Recomendamos encarecidamente establecer el encabezado  a  para habilitar la eliminación asincrónica. De esta manera, evitarás el límite de tasa de 5 eliminaciones por minuto. Cuando se establece, el endpoint responderá con un estado  y proporcionará un ID de solicitud para rastrear el proceso de eliminación. Una vez que el proceso esté completo, recibirás una notificación webhook .
  
  Si no configuras este encabezado, el endpoint responderá con un estado , pero estarás sujeto al límite de tasa de 5 eliminaciones por minuto. Si excedes este límite, recibirás un error .
{% /admonition %}

## Activar una actualización histórica para un enlace

 - [POST /api/links/{id}/refresh/](https://developers.belvo.com/es/apis/belvoopenapispec/links/refreshhistoricaldataforlink.md): {% admonition type="warning" name="Límite de Solicitudes Concurrentes" %}
  Para prevenir solicitudes duplicadas, este endpoint tiene un período de enfriamiento de 10 minutos por enlace. Si intentas actualizar el mismo enlace dentro de los 10 minutos de una solicitud previa, recibirás un error  con el mensaje .
{% /admonition %}

Usa este método para desencadenar una actualización histórica para un enlace específico (único o recurrente). Utiliza el parámetro  para especificar qué recursos deseas actualizar. Si no especificas este parámetro, la actualización histórica se realizará para todos los recursos soportados por la institución con la que está asociado el enlace.

En una solicitud exitosa, nuestra API responderá con un código de estado  y un  que podrás usar posteriormente para asociar un webhook de  a esta solicitud.

{% admonition type="info" name="No actualiza la definición del enlace" %}
  Este endpoint no actualiza la definición del enlace en sí, solo los datos históricos para los recursos especificados. Si deseas cambiar permanentemente el  del enlace, deberías usar el método  en su lugar.
{% /admonition %}