# Owners

Un **owner** representa a la persona que tiene acceso a un Link y es el propietario de todas las cuentas dentro del Link.

Puedes usar este endpoint para obtener información útil sobre tu cliente, como:

- su nombre completo
- información de contacto clave
- información sobre el documento de identificación que usaron al abrir la cuenta

## Lista de propietarios

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

Con el método List Owners, puedes:

1. Listar propietarios relacionados con un link.id específico (usando el parámetro de consulta link).
2. Obtener los detalles de un owners.id específico (usando el parámetro de consulta id).
3. [No Recomendado] Listar todos los propietarios relacionados con tu cuenta de Belvo (sin usar ningún parámetro de consulta).

## 📖 Paginación

Este método devuelve una respuesta paginada (por defecto: 100 elementos por página). Puedes usar el parámetro de consulta page_size para aumentar el número de elementos devueltos hasta un máximo de 1000 elementos. Puedes usar el parámetro de consulta page para navegar a través de los resultados. Para más detalles sobre cómo navegar por las respuestas paginadas de Belvo, consulta nuestro artículo Consejos de Paginación.

## 🔦 Filtrado de Respuestas

Consulta la lista de campos a continuación para ver una lista de campos por los que puedes filtrar tus respuestas. Para más información sobre cómo usar filtros, consulta nuestro artículo Filtrando respuestas.

## 🚨 Campos Obsoletos

Este recurso puede devolver campos obsoletos. En la documentación de la respuesta, puedes ver que un campo ha sido marcado como obsoleto. Esto significa que este campo ya no es mantenido por el equipo de Belvo. Aún puedes recibir datos para este campo dependiendo de la institución, sin embargo, no deberías depender de este campo.

## Recuperar propietarios de un enlace

 - [POST /api/owners/](https://developers.belvo.com/es/apis/belvoopenapispec/owners/retrieveowners.md): Recuperar información del propietario desde un enlace específico.

{% admonition type="info" %}
  Este recurso puede devolver campos obsoletos. Por favor, consulte la documentación de la respuesta para más información.
{% /admonition %}

## Completar una solicitud del propietario

 - [PATCH /api/owners/](https://developers.belvo.com/es/apis/belvoopenapispec/owners/patchowners.md): Se utiliza para reanudar una sesión de recuperación de Owner que se pausó porque la institución requería un token MFA.

{% admonition type="info" %}
  Este recurso puede devolver campos obsoletos. Por favor, consulte la documentación de la respuesta para obtener más información.
{% /admonition %}

## Obtener los detalles de un propietario

 - [GET /api/owners/{id}/](https://developers.belvo.com/es/apis/belvoopenapispec/owners/detailowner.md): Obtener los detalles de un propietario específico.

{% admonition type="info" %}
  Este recurso puede devolver campos obsoletos. Por favor, consulte la documentación de la respuesta para más información.
{% /admonition %}

## Eliminar un propietario

 - [DELETE /api/owners/{id}/](https://developers.belvo.com/es/apis/belvoopenapispec/owners/destroyowner.md): Eliminar un propietario específico de tu cuenta de Belvo.