# Accounts

Uma **conta** é a representação de uma conta bancária dentro de uma instituição financeira. Um usuário pode ter uma ou mais contas em uma instituição.

Por exemplo, um usuário (ou link) pode ter uma conta corrente, vários cartões de crédito e uma conta de empréstimo.

Consultar as informações da conta de um usuário é útil, pois você pode obter informações sobre:

- quais tipos de contas o usuário possui.
- o saldo de cada conta (poupança, corrente, cartão de crédito, empréstimo, etc.).
- informações detalhadas sobre os gastos com cartão de crédito.
- a situação atual de quaisquer empréstimos que possam ter.

## Listar contas

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

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

1. Listar contas relacionadas a um  específico (usando o parâmetro de consulta ).
2. Obter os detalhes de um  específico (usando o parâmetro de consulta ).
3.  Listar todas as contas relacionadas à sua conta Belvo (sem usar nenhum parâmetro de consulta).

## 🔦 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  para aumentar o número de itens retornados até um máximo de 1000 itens. Você pode usar o parâmetro de consulta  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 . 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 contas para um link

 - [POST /api/accounts/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/accounts/retrieveaccounts.md): Recupere contas de um link existente.

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

## Concluir uma solicitação de contas

 - [PATCH /api/accounts/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/accounts/patchaccounts.md): Usado para retomar uma sessão de recuperação de Conta 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 conta

 - [GET /api/accounts/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/accounts/detailaccount.md): Obtenha os detalhes de uma conta 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 conta

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

{% admonition type="danger" name="Rate Limited" %}
  Este endpoint possui limite de taxa. Você pode excluir apenas 5 itens por minuto. Se exceder esse limite, você receberá um código de status .
{% /admonition %}

{% admonition type="info" %}
  Ao excluir uma conta, todas as transações associadas e informações do proprietário para essa conta também são removidas.
{% /admonition %}