# Lista de propietarios

## ▶️ 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.

Endpoint: GET /api/owners/
Version: 1.223.0
Security: basicAuth

## Query parameters:

  - `link` (string)
    El link.id por el que deseas filtrar.

ℹ️ Recomendamos encarecidamente añadir el filtro link.id para mejorar tu rendimiento.
    Example: "8848bd0c-9c7e-4f53-a732-ec896b11d4c4"

  - `page_size` (integer)
    Indica cuántos resultados devolver por página. Por defecto, devolvemos 100 resultados por página.

ℹ️ El número mínimo de resultados devueltos por página es 1 y el máximo es 1000. Si introduces un valor mayor que 1000, nuestra API usará por defecto el valor máximo (1000).
    Example: 100

  - `page` (integer)
    Un número de página dentro del conjunto de resultados paginados.
    Example: 1

  - `omit` (string)
    Omite ciertos campos para que no se devuelvan en la respuesta. Para más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

  - `fields` (string)
    Devuelve solo los campos especificados en la respuesta. Para obtener más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

  - `link__in` (array)
    Devuelve resultados solo para estos link.ids.
    Example: ["5722d0ba-69d7-42dc-8ff5-33767b83c5d6"]

  - `id` (string)
    Devuelve información solo para este recurso id.
    Example: "24ccab1d-3a86-4136-a6eb-e04bf52b356f"

  - `id__in` (array)
    Devuelve información para estos ids de recursos.
    Example: ["6b3dea0f-be29-49d1-aabe-1a6d588642e6"]

  - `created_at` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo en esta fecha (en formato YYYY-MM-DD).
    Example: "2022-05-05"

  - `created_at__gt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después de esta fecha (en formato YYYY-MM-DD).
    Example: "2022-05-05"

  - `created_at__gte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después o en esta fecha (en formato YYYY-MM-DD).
    Example: "2022-05-04"

  - `created_at__lt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes de esta fecha (en formato YYYY-MM-DD).
    Example: "2022-04-01"

  - `created_at__lte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes o en esta fecha (en formato YYYY-MM-DD).
    Example: "2022-03-30"

  - `created_at__range` (array)
    Devolver cuentas que fueron actualizadas por última vez en la base de datos de Belvo entre dos fechas (en formato YYYY-MM-DD). El primer valor indica el inicio del rango y el segundo valor indica el final del rango.
    Example: ["2022-01-01","2022-12-31"]

  - `email` (string)
    Devuelve los propietarios cuya dirección de correo electrónico coincide con tu consulta.
    Example: "lopes.d@gmail.com"

  - `display_name__icontains` (string)
    Devuelve propietarios cuyo nombre completo de visualización coincida parcialmente con tu consulta. Por ejemplo, mar devolverá resultados para Mark, Maria, Neymar, Remarque, etc.
    Example: "Daniela"

## Response 200 fields (application/json):

  - `count` (integer)
    El número total de resultados en tu cuenta de Belvo.
    Example: 130

  - `next` (string,null)
    La URL a la siguiente página de resultados. Cada página consta de hasta 100 elementos. Si no hay suficientes resultados para una página adicional, el valor es null.

En nuestro ejemplo de documentación, usamos {endpoint} como un valor de marcador de posición. En producción, este valor será reemplazado por el endpoint real que estás utilizando actualmente (por ejemplo, accounts o owners).
    Example: "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2"

  - `previous` (string,null)
    La URL a la página anterior de resultados. Si no hay una página anterior, el valor es null.

  - `results` (array) — one of:
    Una matriz de cualquiera de los siguientes:

  - Objetos de Owner Individual (OFDA Brazil)
  - Objetos de Owner Business (OFDA Brazil)
  - Objetos de Owner Standard (Multi-Region)
  
  > 🚧 Un tipo de esquema por respuesta
  >
  > La respuesta contendrá una matriz de uno de los tipos de esquema descritos anteriormente. En otras palabras, no habrá una mezcla de tipos de esquema en la respuesta.
    - Propietario Individual (OFDA Brasil):
      - `id` (string, required)
        Identificador único de Belvo para el elemento actual.
        Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"
      - `link` (string,null, required)
        El link.id al que pertenecen los datos.
        Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"
      - `internal_identification` (string,null, required)
        El identificador interno de la institución para el propietario.
        Example: "7e5838e4"
      - `collected_at` (string, required)
        La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
        Example: "2022-02-09T08:45:50.406032Z"
      - `created_at` (string, required)
        La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
        Example: "2022-02-09T08:45:50.406032Z"
      - `display_name` (string, required)
        El nombre completo del individuo, tal como lo proporciona la institución.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "Jack Oswald White"
      - `social_name` (string,null, required)
        El nombre social del individuo, tal como es generalmente aceptado por el país.
        Example: "O Piadista"
      - `birth_date` (string, required)
        La fecha de nacimiento del individuo, en formato YYYY-MM-DD.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "1988-07-15"
      - `marital_status` (string,null, required)
        El estado civil del individuo. Devolvemos uno de los siguientes valores:

  - SINGLE
  - MARRIED
  - WIDOWED
  - SEPARATED
  - DIVORCED
  - CIVIL_UNION
  - OTHER
        Enum: "SINGLE", "MARRIED", "WIDOWED", "SEPARATED", "DIVORCED", "CIVIL_UNION", "OTHER"
      - `marital_status_additional_info` (string,null, required)
        Información adicional sobre el estado civil del individuo.
        Example: "It's complicated"
      - `gender` (string,null, required)
        El género del individuo. Devolvemos uno de los siguientes valores:

  - FEMALE
  - MALE
  - OTHER
        Enum: "FEMALE", "MALE", "OTHER"
      - `companies_id` (array, required)
        Las instituciones responsables de la creación y verificación del propietario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: ["01773247000103"]
      - `is_local_resident` (boolean, required)
        Boolean para indicar si el individuo es residente local del país.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: true
      - `document_id` (object, required)
        Información sobre el documento de identificación que el propietario proporcionó al banco.

> Non-nullable: La red de finanzas abiertas de Brasil debe devolver un valor.
      - `document_id.document_type` (string, required)
        El tipo de documento que el propietario proporcionó a la institución para abrir la cuenta. Los tipos de documentos comunes son:

🇧🇷 Brasil
- CPF (Cadastro de Pessoas Físicas)
- CNPJ (Cadastro Nacional de Pessoas Jurídicas)

> Non-nullable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "CPF"
      - `document_id.document_number` (string, required)
        El número de identificación del documento.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "235578435-S"
      - `additional_documents` (array, required)
        Información detallada sobre documentos adicionales proporcionados para verificar la identidad de las personas.

> Non-nullable: La red de finanzas abiertas de Brasil debe devolver un valor.
      - `additional_documents.type` (string,null, required)
        El tipo de documento de identificación. Devolvemos uno de los siguientes valores:

  - DRIVERS_LICENSE
  - PASSPORT
  - ID_CARD
  - FISCAL_ID
  - FOREIGNER_REGISTRATION_CARD
  - OTHER
  - null
        Enum: "DRIVERS_LICENSE", "PASSPORT", "ID_CARD", "FISCAL_ID", "FOREIGNER_REGISTRATION_CARD", "OTHER", null
      - `additional_documents.type_additional_info` (string,null, required)
        Información adicional sobre el tipo de documento.

> Nota: Para documentos de identificación empresarial, este campo debe devolver un valor de la red de finanzas abiertas de Brasil.
        Example: "Learner's licence"
      - `additional_documents.number` (string, required)
        El número del documento de identificación.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "DL-7896829-7"
      - `additional_documents.check_digit` (string, required)
        El dígito de verificación del documento de identificación.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "7"
      - `additional_documents.issue_date` (string,null, required)
        La fecha en que se emitió el documento de identificación, en formato YYYY-MM-DD.
        Example: "2019-01-01"
      - `additional_documents.expiration_date` (string,null, required)
        La fecha de vencimiento del documento de identificación, en formato YYYY-MM-DD.
        Example: "2019-01-01"
      - `additional_documents.country_of_issuance` (string,null, required)
        El código de país de tres letras que emitió el documento (en formato ISO-3166 Alpha 3).

Este campo debe ser devuelto cuando el type es PASSPORT.
        Example: "CAN"
      - `additional_documents.additional_info` (string,null, required)
        Información adicional sobre el documento de identificación.
        Example: "The document has water damage"
      - `nationalities` (array,null, required)
        Información detallada sobre las nacionalidades del individuo.

Solo se requiere devolver cuando is_local_resident está configurado como false.
      - `nationalities.info` (string,null, required)
        La nacionalidad del individuo.
        Example: "CAN"
      - `nationalities.documents` (array, required)
      - `nationalities.documents.type` (string,null, required)
        El tipo de documento de identificación. Devolvemos uno de los siguientes valores:

  - DRIVERS_LICENSE
  - PASSPORT
  - ID_CARD
  - FISCAL_ID
  - FOREIGNER_REGISTRATION_CARD
  - OTHER
  - null
        Enum: same as `additional_documents.type` in "Propietario Individual (OFDA Brasil)" (7 values)
      - `nationalities.documents.number` (string, required)
        El número del documento de identificación.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "DL-7896829-7"
      - `nationalities.documents.issue_date` (string,null, required)
        La fecha en que se emitió el documento de identificación, en formato YYYY-MM-DD.
        Example: "2019-01-01"
      - `nationalities.documents.expiration_date` (string,null, required)
        La fecha de vencimiento del documento de identificación, en formato YYYY-MM-DD.
        Example: "2019-01-01"
      - `nationalities.documents.country_of_issuance` (string,null, required)
        El código de país de tres letras que emitió el documento (en formato ISO-3166 Alpha 3).

Este campo debe ser devuelto cuando el type es PASSPORT.
        Example: "CAN"
      - `nationalities.documents.additional_info` (string,null, required)
        Información adicional sobre el documento de identificación.
        Example: "The document has water damage"
      - `email` (string,null, required)
        La dirección de correo electrónico registrada del propietario de la cuenta.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "johndoe@belvo.com"
      - `emails` (array, required)
        Lista adicional de correos electrónicos proporcionada por el propietario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
      - `emails.is_main` (boolean, required)
        Boolean para indicar si este es el correo electrónico principal del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: true
      - `emails.email` (string, required)
        La dirección de correo electrónico del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "homen_morcego@gmail.com"
      - `address` (string,null, required)
        La dirección registrada del propietario de la cuenta.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "Carrer de la Llacuna, 162, 08018 Barcelona"
      - `addresses` (array, required)
        Información detallada sobre las direcciones del propietario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
      - `addresses.is_main` (boolean, required)
        Boolean para indicar si esta es la dirección principal del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: true
      - `addresses.address` (string, required)
        La dirección del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "Av Naburo Ykesaki, 1270"
      - `addresses.additional_info` (string,null, required)
        Información adicional sobre la dirección del usuario.
        Example: "In between two palm trees"
      - `addresses.district_name` (string,null, required)
        El distrito de la dirección.
        Example: "CENTRO"
      - `addresses.town` (string, required)
        La ciudad del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "Brasilia"
      - `addresses.town_code` (string,null, required)
        El código de siete dígitos para la ciudad, si corresponde.

Para Brasil, este es el código de ciudad del IBGE.
        Example: "3550308"
      - `addresses.state` (string,null, required)
        El estado en el que se encuentra la dirección.
        Example: "SP"
      - `addresses.postcode` (string, required)
        El código postal de la dirección.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "17500001"
      - `addresses.country_name` (string, required)
        El nombre del país.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil.
        Example: "Brasil"
      - `addresses.country_code` (string,null, required)
        El código de país de tres letras (cumple con ISO-3166 Alpha 3).
        Example: "BRA"
      - `addresses.latitude` (string,null, required)
        La coordenada de latitud geográfica.
        Example: "-23.5475000"
      - `addresses.longitude` (string,null, required)
        La coordenada de longitud geográfica.
        Example: "-46.6361100"
      - `phone_number` (string,null, required)
        El número de teléfono registrado del propietario de la cuenta.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "+52-XXX-XXX-XXXX"
      - `phone_numbers` (array, required)
        Información detallada sobre los números de teléfono del propietario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
      - `phone_numbers.is_main` (boolean, required)
        Boolean para indicar si este es el número de teléfono principal del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: true
      - `phone_numbers.type` (string,null, required)
        El tipo de número de teléfono. Devolvemos uno de los siguientes valores:

  - LANDLINE
  - MOBILE
  - OTHER
  - null
        Enum: "LANDLINE", "MOBILE", "OTHER", null
      - `phone_numbers.additional_info` (string,null, required)
        Información adicional sobre el número de teléfono.
        Example: "This is their work mobile number."
      - `phone_numbers.number` (string, required)
        El número de teléfono (sin incluir los códigos de país, área o extensión).

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "29875132"
      - `phone_numbers.country_code` (string,null, required)
        El código de marcación del país. Por ejemplo: 351 (sin +).
        Example: "351"
      - `phone_numbers.area_code` (string,null, required)
        El código de marcación de área.
        Example: "21"
      - `phone_numbers.extension` (string,null, required)
        El código de la extensión.
        Example: "932"
      - `filiations` (array, required)
        Información sobre cualquier relación familiar del individuo.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
      - `filiations.type` (string,null, required)
        La relación familiar. Devolvemos uno de los siguientes valores:

  - MOTHER
  - FATHER
  - null
        Enum: "MOTHER", "FATHER", null
      - `filiations.civil_name` (string, required)
        El nombre completo de la persona.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "Bruce Wayne"
      - `filiations.social_name` (string,null, required)
        El nombre social de la persona.
        Example: "The Dark Knight"
      - `financial_profile` (object,null, required)
        Información sobre el perfil financiero del individuo.
      - `financial_profile.company_id` (string,null, required)
        El identificador de la empresa donde está empleado el individuo.
        Example: "50685362000135"
      - `financial_profile.occupation_code` (string,null, required)
        El área de empleo del individuo. Devolvemos uno de los siguientes valores:

  - BRAZIL_PUBLIC_OFFICE
  - BRAZIL_OCCUPATION_CODE
  - OTHER
  - null
        Enum: "BRAZIL_PUBLIC_OFFICE", "BRAZIL_OCCUPATION_CODE", "OTHER", null
      - `financial_profile.occupation_description` (string,null, required)
        Información sobre la ocupación del individuo.
        Example: "01"
      - `financial_profile.informed_income` (object, required)
        Información sobre los ingresos reportados del individuo.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
      - `financial_profile.informed_income.frequency` (string,null, required)
        Indica con qué frecuencia el individuo recibe su salario. Devolvemos uno de los siguientes valores:

  - DAILY
  - WEEKLY
  - FORTNIGHTLY
  - MONTHLY
  - BIMONTHLY
  - QUARTERLY
  - BIANNUALLY
  - ANNUALLY
  - OTHERS
        Enum: "DAILY", "WEEKLY", "FORTNIGHTLY", "MONTHLY", "BIMONTHLY", "QUARTERLY", "BIANNUALLY", "ANNUALLY", "OTHERS"
      - `financial_profile.informed_income.amount` (number, required)
        El ingreso reportado que recibe el individuo.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: 45391.89
      - `financial_profile.informed_income.currency` (string, required)
        El código de moneda de tres letras (ISO-4217).

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "BRL"
      - `financial_profile.informed_income.date` (string, required)
        Fecha en la que el individuo recibió su salario por última vez.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "2020-03-19"
      - `financial_profile.patrimony` (object,null, required)
        Información sobre los activos reportados del individuo (si están disponibles).
      - `financial_profile.patrimony.amount` (number, required)
        Los activos reportados del individuo.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil cuando el objeto patrimony está disponible.
        Example: 45391.89
      - `financial_profile.patrimony.currency` (string, required)
        El código de moneda de tres letras (ISO-4217).

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor cuando el objeto patrimony está disponible.
        Example: "BRL"
      - `financial_profile.patrimony.year` (integer, required)
        El año al que se aplican los activos reportados.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor cuando el objeto patrimony está disponible.
        Example: 2020
      - `financial_relation` (object,null, required)
        Detalles sobre cualquier relación adicional que la persona tenga con la institución (por ejemplo, otras cuentas o productos que tenga con la institución).
      - `financial_relation.start_date` (string, required)
        La marca de tiempo ISO-8601 cuando comenzó la relación financiera entre el individuo y la institución.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "2021-05-21T08:30:00Z"
      - `financial_relation.product_services` (array, required)
        Una lista de productos que el individuo tiene con la institución.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: ["CONTA_DEPOSITO_A_VISTA"]
      - `financial_relation.product_services_additional_info` (string,null, required)
        Información adicional sobre los productos que tiene la persona.
        Example: "Joint account with Robin"
      - `financial_relation.procurators` (array, required)
        Información sobre cualquier individuo o empresa que pueda actuar en nombre del propietario.
      - `financial_relation.procurators.type` (string,null, required)
        El tipo de representante que puede acceder y realizar cambios en la cuenta. Devolvemos uno de los siguientes valores:

  - LEGAL_REPRESENTATIVE
  - ATTORNEY
  - null
        Enum: "LEGAL_REPRESENTATIVE", "ATTORNEY", null
      - `financial_relation.procurators.civil_name` (string, required)
        El nombre completo de los representantes.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo procurators está disponible.
        Example: "Alfred Thaddeus Pennyworth"
      - `financial_relation.procurators.social_name` (string,null, required)
        El nombre social de la persona.
        Example: "Alfred Pennyworth"
      - `financial_relation.procurators.document_number` (string, required)
        El número de documento del representante.

Nota: Para individuos, este es el número de CPF de Brasil. Para empresas, este es el número de CNPJ de Brasil.

> Non-nullable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo procurators está disponible.
        Example: "73677831148"
      - `financial_relation.products` (array, required)
        Detalles sobre cualquier producto adicional que la persona tenga con la institución.
      - `financial_relation.products.type` (string,null, required)
        Los productos adicionales que el individuo tiene en la institución. Devolvemos uno de los siguientes valores:

  - SAVINGS_ACCOUNT
  - CHECKING_ACCOUNT
  - null
        Enum: "SAVINGS_ACCOUNT", "CHECKING_ACCOUNT", null
      - `financial_relation.products.subtype` (string,null, required)
        El subtipo del producto que el individuo tiene en la institución.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo products está disponible.
        Example: "CONJUNTA_SIMPLES"
      - `financial_relation.products.agency` (string,null, required)
        El código de sucursal donde se abrió el producto.
        Example: "6272"
      - `financial_relation.products.clearing_code` (string, required)
        El código de compensación bancaria para el producto.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo products está disponible.
        Example: "001"
      - `financial_relation.products.number` (string, required)
        El número de cuenta del producto.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo procurators está disponible.
        Example: "24550245"
      - `financial_relation.products.check_digit` (string, required)
        El dígito de control del número del producto.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo products está disponible.
        Example: "7"
      - `financial_relation.salary_portability_requests` (array)
        Detalles sobre cualquier solicitud de portabilidad de salario que el individuo haya realizado con la institución.

Una portabilidad de salario es una solicitud para transferir el salario del individuo desde la cuenta bancaria de 'nómina' de su empleador a otra cuenta bancaria.

> 📘 
>
> Tenga en cuenta que la cuenta bancaria receptora no puede terminar una portabilidad de salario (o ser informada de que ha sido terminada). Solo el banco de nómina del empleador puede proporcionar esta información. Por lo tanto, las portabilidades enumeradas aquí pueden no estar actualizadas.
      - `financial_relation.salary_portability_requests.employer_name` (string)
        El nombre del empleador.
        Example: "ACME Inc."
      - `financial_relation.salary_portability_requests.employer_id_number` (string)
        El CPF o CNPJ del empleador.
        Example: 12345678901
      - `financial_relation.salary_portability_requests.employer_bank_id_number` (string)
        El CNPJ del banco del empleador.
        Example: 12345678901234
      - `financial_relation.salary_portability_requests.employer_bank_code` (string)
        El código ISPB (Identificador de Sistema de Pagamentos Brasileiro) del banco del empleador.
        Example: 12345678
      - `financial_relation.salary_portability_requests.portability_approval_date` (string)
        La fecha en que se aprobó la solicitud de portabilidad, en formato YYYY-MM-DD.
        Example: "2024-04-01"
      - `financial_relation.payroll_accounts` (array)
        Detalles sobre cualquier cuenta bancaria de nómina asociada con el individuo. Es decir, cada vez que el individuo tenga un nuevo empleador del cual reciba un salario, debe estar listado aquí.

> 📘
>
> Los empleadores anteriores pueden no cerrar la cuenta de nómina del individuo. Por lo tanto, las cuentas de nómina listadas aquí pueden no estar actualizadas.
      - `financial_relation.payroll_accounts.employer_name` (string)
        El nombre del empleador.
        Example: "ACME Inc."
      - `financial_relation.payroll_accounts.employer_id_number` (string)
        El CPF o CNPJ del empleador.
        Example: 12345678901
      - `financial_relation.payroll_accounts.employer_bank_id_number` (string)
        El CNPJ del banco del empleador.
        Example: 12345678901234
      - `financial_relation.payroll_accounts.employer_bank_code` (string)
        El código ISPB (Identificador de Sistema de Pagamentos Brasileiro) del banco del empleador.
        Example: 12345678
      - `financial_relation.payroll_accounts.account_opening_date` (string)
        La fecha en que se abrió la cuenta bancaria de salario, en formato YYYY-MM-DD.
        Example: "2024-04-01"
    - Propietario del Negocio (OFDA Brasil):
      - `id` (string, required)
        Identificador único de Belvo para el elemento actual.
        Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"
      - `link` (string,null, required)
        El link.id al que pertenecen los datos.
        Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"
      - `internal_identification` (string,null, required)
        El identificador interno de la institución para el propietario.
        Example: "7e5838e4"
      - `collected_at` (string, required)
        La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
        Example: "2022-02-09T08:45:50.406032Z"
      - `created_at` (string, required)
        La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
        Example: "2022-02-09T08:45:50.406032Z"
      - `company_name` (string, required)
        El nombre completo (oficial) del negocio, tal como lo proporciona la institución.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "Wayne Enterprises"
      - `trade_name` (string,null, required)
        El nombre comercial del negocio.
        Example: "WayneCorp"
      - `incorporation_date` (string, required)
        La fecha en que se constituyó la empresa, en formato YYYY-MM-DD.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "1988-07-15"
      - `companies_id` (array, required)
        Las instituciones responsables de la creación y verificación del propietario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: ["01773247000103"]
      - `document_id` (object, required)
        Información sobre el documento de identificación que el propietario proporcionó al banco.

> Non-nullable: La red de finanzas abiertas de Brasil debe devolver un valor.
      - `document_id.document_type` (string, required)
        El tipo de documento que el propietario proporcionó a la institución para abrir la cuenta. Los tipos de documentos comunes son:

🇧🇷 Brasil
- CPF (Cadastro de Pessoas Físicas)
- CNPJ (Cadastro Nacional de Pessoas Jurídicas)

> Non-nullable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "CPF"
      - `document_id.document_number` (string, required)
        El número de identificación del documento.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "235578435-S"
      - `additional_documents` (array, required)
        Información detallada sobre documentos adicionales proporcionados para probar la identificación del negocio.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
      - `additional_documents.type` (string,null, required)
        El tipo de documento de identificación. Devolvemos uno de los siguientes valores:

  - DRIVERS_LICENSE
  - PASSPORT
  - ID_CARD
  - FISCAL_ID
  - FOREIGNER_REGISTRATION_CARD
  - OTHER
  - null
        Enum: same as `additional_documents.type` in "Propietario Individual (OFDA Brasil)" (7 values)
      - `additional_documents.type_additional_info` (string,null, required)
        Información adicional sobre el tipo de documento.

> Nota: Para documentos de identificación empresarial, este campo debe devolver un valor de la red de finanzas abiertas de Brasil.
        Example: "EIN"
      - `additional_documents.number` (string, required)
        El número del documento de identificación.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "DL-7896829-7"
      - `additional_documents.check_digit` (string, required)
        El dígito de verificación del documento de identificación.

> Nota: Este campo no es aplicable para documentos de identificación empresarial y devolverá null.
      - `additional_documents.issue_date` (string,null, required)
        La fecha en que se emitió el documento de identificación, en formato YYYY-MM-DD.

> Nota: Este campo no es aplicable para documentos de identificación empresarial y devolverá null.
      - `additional_documents.expiration_date` (string,null, required)
        La fecha de vencimiento del documento de identificación, en formato YYYY-MM-DD.
        Example: "2019-01-01"
      - `additional_documents.country_of_issuance` (string,null, required)
        El código de país de tres letras que emitió el documento (en formato ISO-3166 Alpha 3).

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "CAN"
      - `additional_documents.additional_info` (string,null, required)
        Información adicional sobre el documento de identificación.

> Nota: Este campo no es aplicable para documentos de identificación empresarial y devolverá null.
      - `email` (string,null, required)
        La dirección de correo electrónico registrada del propietario de la cuenta.
        Example: "johndoe@belvo.com"
      - `emails` (array, required)
        Lista adicional de correos electrónicos proporcionada por el propietario.
      - `emails.is_main` (boolean, required)
        Boolean para indicar si este es el correo electrónico principal del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: true
      - `emails.email` (string, required)
        La dirección de correo electrónico del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "homen_morcego@gmail.com"
      - `address` (string,null, required)
        La dirección registrada del propietario de las cuentas.
        Example: "Carrer de la Llacuna, 162, 08018 Barcelona"
      - `addresses` (array, required)
        Información detallada sobre las direcciones del propietario.
      - `addresses.is_main` (boolean, required)
        Boolean para indicar si esta es la dirección principal del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: true
      - `addresses.address` (string, required)
        La dirección del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "Av Naburo Ykesaki, 1270"
      - `addresses.additional_info` (string,null, required)
        Información adicional sobre la dirección del usuario.
        Example: "In between two palm trees"
      - `addresses.district_name` (string,null, required)
        El distrito de la dirección.
        Example: "CENTRO"
      - `addresses.town` (string, required)
        La ciudad del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "Brasilia"
      - `addresses.town_code` (string,null, required)
        El código de siete dígitos para la ciudad, si corresponde.

Para Brasil, este es el código de ciudad del IBGE.
        Example: "3550308"
      - `addresses.state` (string,null, required)
        El estado en el que se encuentra la dirección.
        Example: "SP"
      - `addresses.postcode` (string, required)
        El código postal de la dirección.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "17500001"
      - `addresses.country_name` (string, required)
        El nombre del país.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil.
        Example: "Brasil"
      - `addresses.country_code` (string,null, required)
        El código de país de tres letras (cumple con ISO-3166 Alpha 3).
        Example: "BRA"
      - `addresses.latitude` (string,null, required)
        La coordenada de latitud geográfica.
        Example: "-23.5475000"
      - `addresses.longitude` (string,null, required)
        La coordenada de longitud geográfica.
        Example: "-46.6361100"
      - `phone_number` (string,null, required)
        El número de teléfono registrado del propietario de la cuenta.
        Example: "+52-XXX-XXX-XXXX"
      - `phone_numbers` (array, required)
        Información detallada sobre los phone_numbers del propietario.
      - `phone_numbers.is_main` (boolean, required)
        Boolean para indicar si este es el número de teléfono principal del usuario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: true
      - `phone_numbers.type` (string,null, required)
        El tipo de número de teléfono. Devolvemos uno de los siguientes valores:

  - LANDLINE
  - MOBILE
  - OTHER
  - null
        Enum: same as `phone_numbers.type` in "Propietario Individual (OFDA Brasil)" (4 values)
      - `phone_numbers.additional_info` (string,null, required)
        Información adicional sobre el número de teléfono.
        Example: "This is their work mobile number."
      - `phone_numbers.number` (string, required)
        El número de teléfono (sin incluir los códigos de país, área o extensión).

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "29875132"
      - `phone_numbers.country_code` (string,null, required)
        El código de marcación del país. Por ejemplo: 351 (sin +).
        Example: "351"
      - `phone_numbers.area_code` (string,null, required)
        El código de marcación de área.
        Example: "21"
      - `phone_numbers.extension` (string,null, required)
        El código de la extensión.
        Example: "932"
      - `parties` (array, required)
        Información detallada sobre las partes autorizadas para actuar en nombre del propietario.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
      - `parties.person_type` (string,null, required)
        El tipo de persona que es parte propietaria de la cuenta. Devolvemos uno de los siguientes valores:

  - INDIVIDUAL
  - COMPANY
        Enum: "INDIVIDUAL", "COMPANY"
      - `parties.type` (string,null, required)
        El tipo de acceso que el person_type tiene a la cuenta. Devolvemos uno de los siguientes valores:

- MEMBER indica que el person_type tiene acceso de lectura a la cuenta.
- ADMINISTRATOR indica que el person_type puede realizar todas las acciones para la cuenta (incluidas las transferencias).
        Enum: "MEMBER", "ADMINISTRATOR"
      - `parties.display_name` (string,null, required)
        El nombre completo de la persona, tal como lo proporciona la institución. Solo aplicable si el person_type es INDIVIDUAL.
        Example: "Jack Oswald White"
      - `parties.social_name` (string,null, required)
        El nombre social del individuo, tal como es generalmente aceptado por el país. Solo aplicable si el person_type es INDIVIDUAL.
        Example: "O Piadista"
      - `parties.company_name` (string,null)
        El nombre completo (oficial) del negocio. Solo aplicable si el person_type es COMPANY.
        Example: "Wayne Enterprises"
      - `parties.trade_name` (string,null, required)
        El nombre comercial del negocio. Solo aplicable si el person_type es COMPANY.
        Example: "WayneCorp"
      - `parties.start_date` (string,null, required)
        La fecha en que la parte fue añadida a la cuenta, en formato YYYY-MM-DD.
        Example: "2021-07-15"
      - `parties.percentage_type` (number,null, required)
        El interés de capital de la parte.
        Example: 0.51
      - `parties.document_type` (string,null, required)
        El tipo de documento de identificación que la parte proporcionó al ser añadida a la cuenta. Devolvemos uno de los siguientes valores:

  - CPF
  - CNPJ
  - OTHER_TRAVEL_DOCUMENT
  - PASSPORT
        Enum: "CPF", "CNPJ", "OTHER_TRAVEL_DOCUMENT", "PASSPORT"
      - `parties.document_number` (string, required)
        El número del documento de identificación.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "DL-7896829-7"
      - `parties.document_issue_date` (string,null, required)
        La fecha en que se emitió el documento de identificación, en formato YYYY-MM-DD.
        Example: "2019-01-01"
      - `parties.document_expiration_date` (string,null, required)
        La fecha de vencimiento del documento de identificación, en formato YYYY-MM-DD.
        Example: "2019-01-01"
      - `parties.document_country` (string,null, required)
        El código de país de tres letras que emitió el documento (en formato ISO-3166 Alpha 3).
        Example: "CAN"
      - `parties.document_additional_info` (string,null, required)
        Información adicional sobre el documento.
        Example: "Confirmed CPF with their driver's licence."
      - `financial_profile` (object,null, required)
        Información sobre el perfil financiero del individuo.
      - `financial_profile.economic_activities` (array, required)
        Detalles sobre las actividades económicas reportadas de la empresa.
      - `financial_profile.economic_activities.is_main` (boolean, required)
        Boolean para indicar si esta es la actividad económica principal del negocio.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo economic_activities está disponible.
        Example: true
      - `financial_profile.economic_activities.code` (string, required)
        El código de la actividad económica, según lo proporcionado por el país.

> Non-nullable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo economic_activities está disponible.
        Example: "8599604"
      - `financial_profile.informed_revenue` (object,null, required)
        Información sobre los ingresos reportados del negocio.
      - `financial_profile.informed_revenue.frequency` (string,null, required)
        Indica con qué frecuencia la empresa declara sus ingresos. Devolvemos uno de los siguientes valores:

  - DAILY
  - WEEKLY
  - FORTNIGHTLY
  - MONTHLY
  - BIMONTHLY
  - QUARTERLY
  - BIANNUALLY
  - ANNUALLY
  - OTHERS
  - null
        Enum: "DAILY", "WEEKLY", "FORTNIGHTLY", "MONTHLY", "BIMONTHLY", "QUARTERLY", "BIANNUALLY", "ANNUALLY", "OTHERS", null
      - `financial_profile.informed_revenue.frequency_additional_info` (string,null, required)
        Información adicional sobre la frecuencia.
        Example: "Recently switched from weekly to monthly."
      - `financial_profile.informed_revenue.amount` (number, required)
        Los ingresos reportados del negocio.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo informed_revenue está disponible.
        Example: 45391.89
      - `financial_profile.informed_revenue.currency` (string, required)
        El código de moneda de tres letras (ISO-4217).

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo informed_revenue está disponible.
        Example: "BRL"
      - `financial_profile.informed_revenue.year` (integer, required)
        El año en que se declaró por última vez el ingreso.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo informed_revenue está disponible.
        Example: 2022
      - `financial_profile.patrimony` (object,null, required)
        Información sobre los activos reportados del individuo.
      - `financial_profile.patrimony.amount` (number, required)
        Los activos reportados del negocio.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo patrimony está disponible.
        Example: 45391.89
      - `financial_profile.patrimony.currency` (string, required)
        El código de moneda de tres letras (ISO-4217).

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo patrimony está disponible.
        Example: "BRL"
      - `financial_profile.patrimony.date` (string, required)
        La fecha en la que se aplicaron los activos reportados, en formato YYYY-MM-DD.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo patrimony está disponible.
        Example: "2022-12-12"
      - `financial_relation` (object,null, required)
        Detalles sobre cualquier relación adicional que la empresa tenga con la institución (por ejemplo, otras cuentas o productos que tengan con la institución).
      - `financial_relation.start_date` (string, required)
        La marca de tiempo ISO-8601 cuando comenzó la relación financiera entre la empresa y la institución.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: "2021-05-21T08:30:00Z"
      - `financial_relation.product_services` (array, required)
        Una lista de productos que la empresa tiene con la institución.

> No anulable: La red de finanzas abiertas de Brasil debe devolver un valor.
        Example: ["CONTA_DEPOSITO_A_VISTA"]
      - `financial_relation.procurators` (array, required)
        Información sobre cualquier individuo o empresa que pueda actuar en nombre del propietario.
      - `financial_relation.procurators.type` (string,null, required)
        El tipo de representante que puede acceder y realizar cambios en la cuenta. Devolvemos uno de los siguientes valores:

  - LEGAL_REPRESENTATIVE
  - ATTORNEY
  - null
        Enum: same as `financial_relation.procurators.type` in "Propietario Individual (OFDA Brasil)" (3 values)
      - `financial_relation.procurators.civil_name` (string, required)
        El nombre completo de los representantes.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo procurators está disponible.
        Example: "Alfred Thaddeus Pennyworth"
      - `financial_relation.procurators.social_name` (string,null, required)
        El nombre social de la persona.
        Example: "Alfred Pennyworth"
      - `financial_relation.procurators.document_number` (string, required)
        El número de documento del representante.

Nota: Para individuos, este es el número de CPF de Brasil. Para empresas, este es el número de CNPJ de Brasil.

> Non-nullable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo procurators está disponible.
        Example: "73677831148"
      - `financial_relation.products` (array, required)
        Detalles sobre cualquier producto adicional que la empresa tenga con la institución.
      - `financial_relation.products.type` (string,null, required)
        Los productos adicionales que el negocio tiene en la institución. Devolvemos uno de los siguientes valores:

  - SAVINGS_ACCOUNT
  - CHECKING_ACCOUNT
  - null
        Enum: same as `financial_relation.products.type` in "Propietario Individual (OFDA Brasil)" (3 values)
      - `financial_relation.products.subtype` (string, required)
        El subtipo del producto que la empresa tiene en la institución.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo products está disponible.
        Example: "CONJUNTA_SIMPLES"
      - `financial_relation.products.agency` (string,null, required)
        El código de sucursal donde se abrió el producto.
        Example: "6272"
      - `financial_relation.products.clearing_code` (string, required)
        El código de compensación bancaria para el producto.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo products está disponible.
        Example: "001"
      - `financial_relation.products.number` (string, required)
        El número de cuenta del producto.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo products está disponible.
        Example: "24550245"
      - `financial_relation.products.check_digit` (string, required)
        El dígito de control del número del producto.

> No anulable: Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo products está disponible.
        Example: "7"
    - Propietario Estándar (Multi-Región):
      - `id` (string, required)
        Identificador único de Belvo para el elemento actual.
        Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"
      - `link` (string,null, required)
        El link.id al que pertenecen los datos.
        Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"
      - `internal_identification` (string,null, required)
        El identificador interno de la institución para el propietario.
        Example: "7e5838e4"
      - `collected_at` (string, required)
        La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
        Example: "2022-02-09T08:45:50.406032Z"
      - `created_at` (string)
        La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
        Example: "2022-02-09T08:45:50.406032Z"
      - `display_name` (string,null, required)
        El nombre completo del propietario, tal como lo proporciona el banco.
        Example: "John Doe"
      - `email` (string,null, required)
        La dirección de correo electrónico registrada del propietario de la cuenta.
        Example: "johndoe@belvo.com"
      - `phone_number` (string,null, required)
        El número de teléfono registrado del propietario de la cuenta.
        Example: "+52-XXX-XXX-XXXX"
      - `address` (string,null, required)
        La dirección registrada del propietario de las cuentas.
        Example: "Carrer de la Llacuna, 162, 08018 Barcelona"
      - `document_id` (object,null)
        Información sobre el documento de identificación que el propietario proporcionó al banco.
      - `document_id.document_type` (string,null, required)
        El tipo de documento que el propietario proporcionó a la institución para abrir la cuenta. Los tipos de documentos comunes son:

🇧🇷 Brasil
- CPF (Cadastro de Pessoas Físicas)
- CNPJ (Cadastro Nacional de Pessoas Jurídicas)

🇨🇴 Colombia
- CC (Cédula de Ciudadanía)
- NIT (Número de Identificación Tributaria)

🇲🇽 México
- CURP (Clave Única de Registro de Población)
- NSS (Número de Seguridad Social)
- RFC (Registro Federal de Contribuyentes)
        Example: "CPF"
      - `document_id.document_number` (string,null, required)
        El número de identificación del documento.
        Example: "235578435-S"
      - `business_name` (string,null)
        Este campo ha quedado obsoleto. Para obtener más información sobre Belvo y la obsolescencia, consulta nuestra explicación de campos obsoletos.

El nombre del negocio.
      - `first_name` (string,null)
        Este campo ha quedado obsoleto. Para obtener más información sobre Belvo y la obsolescencia, consulte nuestra explicación de campos obsoletos.

El nombre del propietario de la cuenta.
      - `last_name` (string,null)
        Este campo ha sido desaprobado. Para obtener más información sobre Belvo y la desaprobación, consulta nuestra explicación de campos desaprobados.

El apellido del titular de la cuenta.
      - `second_last_name` (string,null)
        Este campo ha sido desaprobado. Para obtener más información sobre Belvo y la desaprobación, consulta nuestra explicación de campos desaprobados.

El segundo apellido del titular de la cuenta.

## Response 403 fields (application/json):

  - `code` (string)
    Un código de error único (access_to_resource_denied) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    Una breve descripción del error.

Para los errores access_to_resource_denied, la descripción es:

  - You don't have access to this resource..
    Example: "You don't have access to this resource."

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 404 fields (application/json):

  - `code` (string)
    Un código de error único (not_found) que te permite clasificar y manejar el error de manera programática.
    Example: "not_found"

  - `message` (string)
    Una breve descripción del error.

Para errores not_found, la descripción es:

  - Not found
    Example: "Not found"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    Un código de error único (request_timeout) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 408 request_timeout.
    Example: "request_timeout"

  - `message` (string)
    Una breve descripción del error.

Para los errores de request_timeout, la descripción es:

  - The request timed out, you can retry asking for less data by changing your query parameters.
    Example: "The request timed out, you can retry asking for less data by changing your query parameters"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 428 fields (application/json):

  - `code` (string)
    Un código de error único (token_required) que te permite clasificar y manejar el error de forma programática. ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 428 token_required.
    Example: "token_required"

  - `message` (string)
    Una breve descripción del error. 
Para los errores token_required, la descripción es:

  - A MFA token is required by the institution to login.
    Example: "A MFA token is required by the institution to login"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

  - `session` (string)
    Un ID único de 32 caracteres de la sesión de inicio de sesión (que coincide con un patrón de regex de: [a-f0-9]{32}).
    Example: "2675b703b9d4451f8d4861a3eee54449"

  - `expiry` (integer)
    Tiempo de duración de la sesión en segundos.
    Example: 9600

  - `link` (string)
    Identificador único creado por Belvo, utilizado para referenciar el Link actual.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `token_generation_data` (object)
    Detalles sobre cómo generar el token.

  - `token_generation_data.instructions` (string)
    Instrucciones para la generación de tokens.
    Example: "Use this code to generate the token"

  - `token_generation_data.type` (string)
    Tipo de datos para generar el token (código QR, desafío numérico).
    Example: "numeric"

  - `token_generation_data.value` (string)
    Valor a utilizar para generar el token.
    Example: "12345"

  - `token_generation_data.expects_user_input` (boolean)
    Indica si el usuario necesita proporcionar información para completar la autenticación. Cuando se establece en false, es posible que su usuario necesite:
- confirmar el inicio de sesión en otro dispositivo
- escanear un código QR
Aún necesitará realizar una llamada PATCH para completar la solicitud.
    Example: true

## Response 500 fields (application/json):

  - `code` (string)
    Un código de error único (unexpected_error) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Una breve descripción del error.

Para los errores unexpected_error, la descripción es:

- Belvo no puede procesar la solicitud debido a un problema interno del sistema o a una respuesta no soportada de una institución.
    Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"