# Invoices

## Listar facturas

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

Con el método Listar Facturas, puedes:

1. Listar facturas relacionadas con un link.id específico (usando el parámetro de consulta link).
2. Obtener los detalles de un invoice.id específico (usando el parámetro de consulta id).
3. [No Recomendado] Listar todas las facturas relacionadas con tu cuenta de Belvo (sin usar ningún 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 page_size para aumentar el número de elementos devueltos hasta un máximo de 1000 elementos. Puedes usar el parámetro de consulta page 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 una lista de 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.

## 🚨 Campos Obsoletos

Este recurso puede devolver campos obsoletos. En la documentación de la respuesta, puedes ver que un campo ha sido marcado como obsoleto. 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 facturas para un enlace

 - [POST /api/invoices/](https://developers.belvo.com/es/apis/belvoopenapispec/invoices/retrieveinvoices.md): Recuperar información de la factura desde un enlace fiscal específico.

> 📘 Información
>
> Puedes solicitar hasta un año (365 días) de facturas por solicitud. Si necesitas facturas por más de un año, simplemente realiza otra solicitud.

> 🚧 Advertencia
>
> Este recurso puede devolver campos obsoletos. Por favor, consulta la documentación de la respuesta para más información.

## Completar una solicitud de facturas

 - [PATCH /api/invoices/](https://developers.belvo.com/es/apis/belvoopenapispec/invoices/patchinvoices.md): Se utiliza para reanudar una sesión de recuperación de Factura que se pausó porque la institución requería 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 factura

 - [GET /api/invoices/{id}/](https://developers.belvo.com/es/apis/belvoopenapispec/invoices/detailinvoice.md): Obtener los detalles de una factura 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 factura

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

