# Balances

Um saldo é a quantidade de dinheiro disponível em uma determinada conta bancária (corrente ou poupança) em um determinado momento.

## Listar saldos

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

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

1. [Obrigatório] Listar saldos relacionados a um link.id específico (usando o parâmetro de consulta link).
2. [Altamente Recomendado] Listar saldos relacionados a um link.id e account.id específicos (usando os parâmetros de consulta link e account).
3. Obter os detalhes de um balance.id específico (usando o parâmetro de consulta id).

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

## 📖 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, veja nosso artigo Dicas de Paginação.

## 🚨 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 o saldo atual de um link

 - [POST /api/br/balances/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/balances/retrievebalances.md): Recupere o saldo atual de todas as contas correntes e de poupança para um link existente. Recomendamos também enviar o account.id para que você receba os saldos de uma conta específica.

## Obter os detalhes de um saldo

 - [GET /api/br/balances/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/balances/detailbalance.md): Obtenha os detalhes de um saldo específico.