# Owners

Um **proprietário** representa a pessoa que tem acesso a um Link e é o proprietário de todas as contas dentro do Link.

Você pode usar este endpoint para obter informações úteis sobre seu cliente, como:

- seu nome completo
- informações de contato principais
- informações sobre o documento de identidade que usaram ao abrir a conta

## Listar proprietários

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

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

1. Listar proprietários relacionados a um link.id específico (usando o parâmetro de consulta link).
2. Obter os detalhes de um owners.id específico (usando o parâmetro de consulta id).
3. [Não Recomendado] Listar todos os proprietários relacionados à 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.

## 🚨 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 proprietários de um link

 - [POST /api/owners/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/owners/retrieveowners.md): Recupere informações do proprietário a partir de um link específico.

{% 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 do proprietário

 - [PATCH /api/owners/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/owners/patchowners.md): Usado para retomar uma sessão de recuperação de Proprietário 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 um proprietário

 - [GET /api/owners/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/owners/detailowner.md): Obtenha os detalhes de um proprietário específico.

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

## Excluir um proprietário

 - [DELETE /api/owners/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/owners/destroyowner.md): Excluir um proprietário específico da sua conta Belvo.