# Invoices

## Listar faturas

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

Com o método Listar Faturas, você pode:

1. Listar faturas relacionadas a um link.id específico (usando o parâmetro de consulta link).
2. Obter os detalhes de um invoice.id específico (usando o parâmetro de consulta id).
3. [Não Recomendado] Listar todas as faturas relacionadas à sua conta Belvo (sem usar nenhum parâmetro de consulta).

## 📖 Paginação

Este método retorna uma resposta paginada (padrão: 100 itens por página). Você pode usar o parâmetro de consulta page_size para aumentar o número de itens retornados até um máximo de 1000 itens. Você pode usar o parâmetro de consulta page para navegar pelos resultados. Para mais detalhes sobre como navegar pelas respostas paginadas da Belvo, consulte nosso artigo Dicas de Paginação.

## 🔦 Filtrando Respostas

Consulte a lista de consultas abaixo para ver uma lista de campos pelos quais você pode filtrar suas respostas. Para mais informações sobre como usar filtros, veja nosso artigo Filtrando respostas.

## 🚨 Campos Obsoletos

Este recurso pode retornar campos obsoletos. Na documentação de resposta, você pode ver que um campo foi marcado como obsoleto. Isso significa que este campo não é mais mantido pela equipe da Belvo. Você ainda pode receber dados para este campo dependendo da instituição, no entanto, não deve confiar neste campo.

## Recuperar faturas para um link

 - [POST /api/invoices/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/invoices/retrieveinvoices.md): Recupere informações de faturas a partir de um link fiscal específico.

> 📘 Informação
>
> Você pode solicitar até um ano (365 dias) de faturas por solicitação. Se precisar de faturas por mais de um ano, basta fazer outra solicitação.

> 🚧 Aviso
>
> Este recurso pode retornar campos obsoletos. Por favor, verifique a documentação da resposta para mais informações.

## Concluir uma solicitação de faturas

 - [PATCH /api/invoices/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/invoices/patchinvoices.md): Usado para retomar uma sessão de recuperação de Fatura que foi pausada porque um token MFA foi exigido pela instituição.

{% admonition type="info" %}
  Este recurso pode retornar campos obsoletos. Por favor, verifique a documentação da resposta para mais informações.
{% /admonition %}

## Obter os detalhes de uma fatura

 - [GET /api/invoices/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/invoices/detailinvoice.md): Obtenha os detalhes de uma fatura específica.

{% admonition type="info" %}
  Este recurso pode retornar campos obsoletos. Por favor, verifique a documentação da resposta para mais informações.
{% /admonition %}

## Excluir uma fatura

 - [DELETE /api/invoices/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/invoices/destroyinvoice.md): Excluir uma fatura específica da sua conta Belvo.