# Incomes

Use o endpoint Incomes para obter insights sobre as fontes de renda de uma conta nos últimos 365 dias. O endpoint é particularmente útil quando você deseja verificar a renda de uma pessoa.

> 📘 Info
>
> O recurso incomes está **disponível apenas** para contas Corrente e Poupança associadas a links bancários.

## Listar rendimentos

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

Com o método List Incomes, você pode:

1. Listar rendas relacionadas a um link.id específico (usando o parâmetro de consulta link).
2. Obter os detalhes de uma income.id específica (usando o parâmetro de consulta id).
3. [Não Recomendado] Listar todas as rendas 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 nas 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, consulte nosso artigo Filtrando respostas.

## Recuperar rendimentos para um link

 - [POST /api/incomes/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/incomes/retrieveincome.md): Recupere insights de renda para contas correntes e poupança a partir de um link específico. Você pode receber insights para um período de até 365 dias, dependendo do histórico de transações disponível para cada instituição.

## Obter detalhes de uma renda

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

## Excluir uma receita

 - [DELETE /api/incomes/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/incomes/destroyincomes.md): Exclua uma renda específica da sua conta Belvo.