# Recuperar detalles de deuda para un enlace

Recuperar información de los informes de deuda para un enlace fiscal específico.

Endpoint: POST /api/cl/debt-reports/
Version: 1.223.0
Security: basicAuth

## Header parameters:

  - `X-Belvo-Request-Mode` (string)
    Parámetro de encabezado recomendado para hacer que tu solicitud POST sea asincrónica (evitando así tiempos de espera y mejorando el flujo de datos).

Cuando realizas una solicitud asincrónica, Belvo responde con un payload , que incluye el . Una vez que hayamos recuperado la información solicitada, recibirás un webhook con el enlace y los IDs de solicitud.
    Enum: "async"

## Query parameters:

  - `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.

## Request fields (application/json):

  - `link` (string, required)
    El  para el que deseas recuperar información.
    Example: "c81a1dea-6dd6-4999-8b9f-541ee8197058"

  - `attach_pdf` (boolean)
    Cuando se establece en , recibirás el PDF en formato binario en la respuesta.
    Example: true

  - `save_data` (boolean)
    Indica si se debe o no persistir los datos en Belvo. Por defecto, esto está configurado en  y devolvemos una respuesta 201 Created.

Cuando se establece en , los datos no se persistirán y devolvemos una respuesta 200 OK.
    Example: true

## Response 200 fields (application/json):

  - `id` (string)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `link` (string,null)
    El  al que pertenecen los datos.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `collected_at` (string)
    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"

  - `personal_data` (object)

  - `personal_data.full_name` (string)
    El nombre completo del individuo.
    Example: "Cabezas Pérez Martín Vicente "

  - `personal_data.document_id_type` (string)
    El tipo de identificación de documento del individuo. Para Chile, esto siempre se establecerá en .
    Enum: "RUT"

  - `personal_data.document_id_number` (string)
    El número de identificación del documento del individuo. Para Chile, este será el número RUT.
    Example: "12345678-9"

  - `debt_data_last_update` (string)
    La fecha en que se actualizaron por última vez los datos de la deuda, en formato .
    Example: "2023-07-02"

  - `currency` (string)
    La moneda de las deudas. Para Chile, esto será el .
    Example: "CLP"

  - `total` (number,null)
    El monto total de la deuda, incluyendo deudas actuales, morosas, gravemente morosas y en incumplimiento.
    Example: 6506000.02

  - `current` (number,null)
    La cantidad de deuda que actualmente está pendiente pero no vencida.
    Example: 5350000.02

  - `delinquent` (number,null)
    La cantidad de deuda que tiene un retraso de 30 a 59 días.

  - `severely_delinquent` (number,null)
    La cantidad de deuda que tiene un retraso de 60-89 días.
    Example: 56000.02

  - `defaulted` (number,null)
    La cantidad de deuda que tiene un retraso de 90 días.
    Example: 1100000.02

  - `direct_debts` (array,null)
    Una lista de deudas que se atribuyen directamente al individuo.

  - `direct_debts.financial_institution` (string)
    El nombre de la institución financiera donde se mantiene la deuda.
    Example: "Banco Santander"

  - `direct_debts.credit_type` (string)
    El tipo de crédito emitido por la institución financiera. Por ejemplo, , ,  o .
    Example: "Vivienda"

  - `direct_debts.amount` (number)
    El monto total de la deuda en la institución financiera.
    Example: 5000000.02

  - `direct_debts.current` (number,null)
    El monto pendiente actual de la deuda en la institución financiera.
    Example: 5000000.02

  - `indirect_debts` (array,null)
    Lista de deudas indirectas de instituciones financieras.

  - `indirect_debts.financial_institution` (string)
    Nombre de la institución financiera que proporciona la deuda indirecta.
    Example: "Banco BCI"

  - `credit_lines` (array,null)
    Lista de líneas de crédito (como tarjetas de crédito) disponibles para el individuo.

  - `credit_lines.financial_institution` (string)
    El nombre de la institución financiera que proporciona la línea de crédito.
    Example: "Banco BCI"

  - `credit_lines.direct_amount` (number,null)
    La cantidad de crédito directo disponible.
    Example: 5000000.02

  - `credit_lines.indirect_amount` (number,null)
    La cantidad de crédito indirecto disponible.

  - `other_credits` (array,null)
    Lista de otros créditos (como notas de garantía, crédito extranjero, etc.) disponibles para el individuo.

  - `other_credits.financial_institution` (string)
    El nombre de la institución financiera que proporciona el crédito.
    Example: "Banco BCI"

## Response 201 fields (application/json):

  - `id` (string)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `link` (string,null)
    El  al que pertenecen los datos.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `collected_at` (string)
    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"

  - `personal_data` (object)

  - `personal_data.full_name` (string)
    El nombre completo del individuo.
    Example: "Cabezas Pérez Martín Vicente "

  - `personal_data.document_id_type` (string)
    El tipo de identificación de documento del individuo. Para Chile, esto siempre se establecerá en .
    Enum: "RUT"

  - `personal_data.document_id_number` (string)
    El número de identificación del documento del individuo. Para Chile, este será el número RUT.
    Example: "12345678-9"

  - `debt_data_last_update` (string)
    La fecha en que se actualizaron por última vez los datos de la deuda, en formato .
    Example: "2023-07-02"

  - `currency` (string)
    La moneda de las deudas. Para Chile, esto será el .
    Example: "CLP"

  - `total` (number,null)
    El monto total de la deuda, incluyendo deudas actuales, morosas, gravemente morosas y en incumplimiento.
    Example: 6506000.02

  - `current` (number,null)
    La cantidad de deuda que actualmente está pendiente pero no vencida.
    Example: 5350000.02

  - `delinquent` (number,null)
    La cantidad de deuda que tiene un retraso de 30 a 59 días.

  - `severely_delinquent` (number,null)
    La cantidad de deuda que tiene un retraso de 60-89 días.
    Example: 56000.02

  - `defaulted` (number,null)
    La cantidad de deuda que tiene un retraso de 90 días.
    Example: 1100000.02

  - `direct_debts` (array,null)
    Una lista de deudas que se atribuyen directamente al individuo.

  - `direct_debts.financial_institution` (string)
    El nombre de la institución financiera donde se mantiene la deuda.
    Example: "Banco Santander"

  - `direct_debts.credit_type` (string)
    El tipo de crédito emitido por la institución financiera. Por ejemplo, , ,  o .
    Example: "Vivienda"

  - `direct_debts.amount` (number)
    El monto total de la deuda en la institución financiera.
    Example: 5000000.02

  - `direct_debts.current` (number,null)
    El monto pendiente actual de la deuda en la institución financiera.
    Example: 5000000.02

  - `indirect_debts` (array,null)
    Lista de deudas indirectas de instituciones financieras.

  - `indirect_debts.financial_institution` (string)
    Nombre de la institución financiera que proporciona la deuda indirecta.
    Example: "Banco BCI"

  - `credit_lines` (array,null)
    Lista de líneas de crédito (como tarjetas de crédito) disponibles para el individuo.

  - `credit_lines.financial_institution` (string)
    El nombre de la institución financiera que proporciona la línea de crédito.
    Example: "Banco BCI"

  - `credit_lines.direct_amount` (number,null)
    La cantidad de crédito directo disponible.
    Example: 5000000.02

  - `credit_lines.indirect_amount` (number,null)
    La cantidad de crédito indirecto disponible.

  - `other_credits` (array,null)
    Lista de otros créditos (como notas de garantía, crédito extranjero, etc.) disponibles para el individuo.

  - `other_credits.financial_institution` (string)
    El nombre de la institución financiera que proporciona el crédito.
    Example: "Banco BCI"

## Response 403 fields (application/json):

  - `code` (string)
    Un código de error único () 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 , la descripción es:

  - .
    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: ). 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 () 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 , la descripción es:

  -
    Example: "Not found"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). 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 () 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 , la descripción es:

  - .
    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: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 500 fields (application/json):

  - `code` (string)
    Un código de error único () 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 , la descripción es:

- .
    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: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"