> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pruff.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener informe de buró

> Devuelve el informe de buró de un RUT, tomado de la última consulta de buró que tu empresa realizó en Pruff: morosidad con el detalle de cada documento, protestos, puntaje de riesgo, bienes, socios, ejecutivos y consultas de otras empresas. Sirve para empresas y para personas: la forma de `data` depende de `isPerson` (`false` para empresa, `true` para persona). Es un endpoint de solo lectura: nunca dispara una consulta nueva ni consume créditos. Si no hay un informe de buró disponible para ese RUT (tu empresa nunca lo consultó, el RUT no existe en Pruff o no se pudo leer el informe en este momento), responde `200` con `data` y `lastUpdate` en `null`. Reintenta antes de asumir que el informe no existe. Para tener datos actualizados debes hacer la consulta desde la plataforma de Pruff. Los ejemplos se recortaron a unas pocas entradas por lista.

Con `date` obtienes el informe guardado ese día en vez del último, con la misma forma. Los días disponibles los entrega `GET /datahub/{identifier}/buro/history`. Si ese día no hay informe, responde `200` con `data` y `lastUpdate` en `null`. Se guarda un informe por día: si se consultó varias veces el mismo día, queda uno solo.



## OpenAPI

````yaml openapi/clients.yaml GET /datahub/{identifier}/buro
openapi: 3.1.0
info:
  title: API de clientes de Pruff
  version: '1'
  description: >-
    Endpoints que tus sistemas llaman para leer y operar los datos de tu empresa
    en Pruff. Todas las solicitudes van por HTTPS y se autentican con el header
    `x-api-key`. Las convenciones de formato, paginación y errores se describen
    en https://docs.pruff.com/api/introduccion.
servers:
  - url: https://api.pruff.com/api/clients
security:
  - ApiKeyAuth: []
tags:
  - name: Facturas
    description: Consulta de facturas electrónicas, facturas transables y cesiones.
  - name: Documentos
    description: Consulta y creación de documentos asociados a tus clientes.
  - name: Archivos
    description: Carga de archivos a operaciones y a los requerimientos de tus documentos.
  - name: Financiamiento
    description: >-
      Simula créditos, crea solicitudes de factoring y consulta las prórrogas de
      tu empresa.
  - name: Comité
    description: >-
      Consulta las aprobaciones de una solicitud en los comités de riesgo y de
      operaciones, y registra nuevas firmas.
  - name: Chat
    description: Exporta y envía mensajes del chat de una solicitud.
  - name: Reportes
    description: >-
      Reportes de operaciones, cartera, recaudaciones, cuentas pendientes y
      flujos de tu empresa.
  - name: Datahub
    description: >-
      Consulta de la información tributaria, financiera y de riesgo que Pruff
      tiene de tus clientes y deudores.
  - name: Mercado Público
    description: >-
      Licitaciones y órdenes de compra de Mercado Público (ChileCompra) cargadas
      en Pruff.
  - name: CRM
    description: >-
      Datos comerciales de tu CRM en Pruff: empresas con su ficha, pipeline,
      prospectos, gestiones y simulaciones.
  - name: SGR
    description: Operaciones SGR (garantías) de tu empresa.
  - name: Sincronizador
    description: >-
      Pide sincronizar a un cliente con el SII o la TGR para obtener su
      información más actualizada, y consulta el estado de esas
      sincronizaciones.
  - name: Usuarios
    description: >-
      Administra los usuarios de tu empresa en Pruff (crear, editar, eliminar,
      consultar su perfil y asignar subordinados) y consulta las cuentas
      (empresas conectadas) a las que cada usuario tiene acceso.
  - name: Contactos
    description: Crea contactos asociados a las empresas de tu cartera.
paths:
  /datahub/{identifier}/buro:
    get:
      tags:
        - Datahub
      summary: Obtener informe de buró
      description: >-
        Devuelve el informe de buró de un RUT, tomado de la última consulta de
        buró que tu empresa realizó en Pruff: morosidad con el detalle de cada
        documento, protestos, puntaje de riesgo, bienes, socios, ejecutivos y
        consultas de otras empresas. Sirve para empresas y para personas: la
        forma de `data` depende de `isPerson` (`false` para empresa, `true` para
        persona). Es un endpoint de solo lectura: nunca dispara una consulta
        nueva ni consume créditos. Si no hay un informe de buró disponible para
        ese RUT (tu empresa nunca lo consultó, el RUT no existe en Pruff o no se
        pudo leer el informe en este momento), responde `200` con `data` y
        `lastUpdate` en `null`. Reintenta antes de asumir que el informe no
        existe. Para tener datos actualizados debes hacer la consulta desde la
        plataforma de Pruff. Los ejemplos se recortaron a unas pocas entradas
        por lista.


        Con `date` obtienes el informe guardado ese día en vez del último, con
        la misma forma. Los días disponibles los entrega `GET
        /datahub/{identifier}/buro/history`. Si ese día no hay informe, responde
        `200` con `data` y `lastUpdate` en `null`. Se guarda un informe por día:
        si se consultó varias veces el mismo día, queda uno solo.
      operationId: getDatahubBuro
      parameters:
        - name: identifier
          in: path
          required: true
          description: >-
            RUT del cliente, sin puntos, con guion y con la K del dígito
            verificador en mayúscula (por ejemplo `76111111-6`). También se
            acepta un NIT colombiano con el formato `XXXXXXXXX-Y`. Un
            identificador que no es un RUT ni un NIT válido responde `400`.
            Envía el RUT con su dígito verificador correcto.
          schema:
            type: string
            example: 76111111-6
            pattern: ^(\d{1,8}-[\dK]|\d{1,15}-\d)$
          example: 76111111-6
        - name: date
          in: query
          required: false
          description: >-
            Día del informe que quieres, en formato `YYYY-MM-DD`. Sin este
            parámetro se devuelve el informe más reciente. Con él, `lastUpdate`
            es ese día a las 00:00 UTC, porque el informe se guarda por día y
            sin hora.
          schema:
            type: string
            format: date
          example: '2026-10-14'
      responses:
        '200':
          description: Informe de buró, o respuesta vacía si no hay consulta registrada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatahubBuroResponse'
              examples:
                empresa:
                  summary: Empresa
                  value:
                    data:
                      identifier: 76111111-6
                      isPerson: false
                      companySummary:
                        businessName: Cliente Ejemplo SpA
                        startDate: '2015-03-01T00:00:00.000Z'
                        email: contacto@example.com
                        companySize: MEDIANA
                        collaborators: 45
                        everclean: '0'
                        totalConsults: 3
                        activities:
                          - activityCode: '620100'
                            description: ACTIVIDADES DE PROGRAMACION INFORMATICA
                        bankAccounts:
                          - bank_name: BANCO EJEMPLO
                        executives:
                          - name: ANA
                            fatherSurname: PEREZ
                            motherSurname: SOTO
                            rut: 11111111-1
                            roleDescription: GERENTE GENERAL
                            email: ana@example.com
                            phoneNumber: '+56911111111'
                            executiveInformationDate: '2024-01-15T00:00:00.000Z'
                        mainPartners:
                          - businessName: HOLDING EJEMPLO SPA
                            rutOfTheCompany: 77222222-K
                            partnerCount: 2
                            partnershipCount: 1
                        relatedPartners:
                          - namePartner: ANA PEREZ
                            rutPartner: 11111111-1
                            partnerCount: 1
                            partnershipCount: 4
                        consultsByOthers:
                          - businessName: Factoring Consultante SpA
                            report: INFORME COMERCIAL
                            date: '2026-09-10T00:00:00.000Z'
                      summary:
                        debt:
                          accessCamaraComercio: true
                          totalMultaeInfraccionLaboralPrevisional: 0
                          total:
                            amount: 0
                            document: 0
                          boled:
                            amount: 0
                            documentCount: 0
                            documents: []
                          bolcom:
                            amount: 1250000
                            documentCount: 1
                            documents:
                              - libradorName: ACREEDOR SPA
                                documentType: LETRA
                                unpaidAmount: '1250000'
                                registerDate: '2026-07-10T00:00:00.000Z'
                                equifaxRegisterDate: '2026-07-12T00:00:00.000Z'
                                justificationDate: null
                                expirationDate: '2026-06-30T00:00:00.000Z'
                                visibilityDate: null
                          bolab:
                            amount: 0
                            documentCount: 0
                            documents: []
                          icom:
                            amount: 0
                            documentCount: 0
                            documents: []
                          protests:
                            amount: 480000
                            documentCount: 2
                            documents: []
                          dued:
                            amount: 0
                            document: 0
                        accreditationsFlag: true
                        vehiclesNumber: 2
                        vehiclesValuatio: 25000000
                        riskScore:
                          score: '850'
                          historicalRate:
                            - name: 2026-09
                              value: '850'
                            - name: 2026-08
                              value: '820'
                      tributarySummary:
                        realState:
                          propertiesCount: '1'
                          totalAssesmentAmountPesos: '150000000'
                        vehicles: []
                        economicActivity:
                          - activityCode: '620100'
                            description: ACTIVIDADES DE PROGRAMACION INFORMATICA
                        bankruptciesQuantity: 0
                    lastUpdate: '2026-09-15T14:30:00.000Z'
                persona:
                  summary: Persona
                  value:
                    data:
                      identifier: 11111111-1
                      isPerson: true
                      identificationDetails:
                        name: ANA PEREZ SOTO
                        age: 41
                        Gender: FEMENINO
                        death: false
                        birthDate: '1985-05-20T00:00:00.000Z'
                        maritalStatus: CASADA
                        nationality: CHILENA
                        profession: INGENIERA
                        emails:
                          - ana@example.com
                        salary: 1800000
                        addresses:
                          - StreetAndNumber: AV. EJEMPLO 742
                            Communes: PROVIDENCIA
                            Region: METROPOLITANA
                            AddressDate: '2025-02-01T00:00:00.000Z'
                        phones:
                          - Telephone: '+56922222222'
                            SourceOfTelephone: COMERCIAL
                            TelephoneDate: '2025-03-01T00:00:00.000Z'
                        other:
                          DateUpdateIse: null
                      debts:
                        summary:
                          docsAmountLast6: 320000
                          docsAmountLast12: 320000
                          docsAmountLast24: 320000
                          docsAmountMoreThan24: 0
                        accessCamaraComercio: true
                        totalMultaeInfraccionLaboralPrevisional: 0
                        total:
                          amount: 0
                          document: 0
                        boled:
                          amount: 0
                          documentCount: 0
                          documents: []
                        bolcom:
                          amount: 0
                          documentCount: 0
                          documents: []
                        bolab:
                          amount: 0
                          documentCount: 0
                          documents: []
                        icom:
                          amount: 320000
                          documentCount: 1
                          documents:
                            - documentType: CUOTA
                              unpaidAmount: '320000'
                              registerDate: '2026-08-01T00:00:00.000Z'
                              equifaxRegisterDate: '2026-08-03T00:00:00.000Z'
                              justificationDate: null
                              expirationDate: '2026-07-25T00:00:00.000Z'
                              visibilityDate: null
                        protests:
                          amount: 0
                          documentCount: 0
                          documents: []
                        dued:
                          amount: 0
                          document: 0
                      patrimony:
                        societies: []
                        gse: C1
                        detailOrders: []
                        bankAccounts:
                          - bank_name: BANCO EJEMPLO
                        boletinConcursal: []
                        realStateValuation: 90000000
                        realStateNumber: 1
                        vehiclesNumber: 1
                        vehiclesValuation: 8000000
                        riskScore:
                          score: '850'
                          historicalRate:
                            - name: 2026-09
                              value: '850'
                        everclean: '1'
                        consultsByOthers: []
                      tributary:
                        economicCode: '620100'
                        economicActivity: PROGRAMACION
                        observations: 0
                      consults:
                        historic:
                          - businessName: Factoring Consultante SpA
                            report: INFORME COMERCIAL
                            date: '2026-09-10T00:00:00.000Z'
                        count: 1
                    lastUpdate: '2026-09-15T14:30:00.000Z'
                sinConsulta:
                  summary: Sin consulta previa
                  value:
                    data: null
                    lastUpdate: null
        '400':
          description: >-
            El `identifier` no es un RUT o NIT válido, o `date` no tiene el
            formato `YYYY-MM-DD`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
              examples:
                invalidIdentifier:
                  summary: RUT no válido
                  value:
                    message: invalid_union
                    displayMessage: El RUT o Nit ingresado no es válido.
                    data:
                      errors:
                        - path: identifier
                          message: El RUT o Nit ingresado no es válido.
                          code: invalid_union
                invalidDate:
                  summary: Fecha con otro formato
                  value:
                    message: invalid_format
                    displayMessage: Date must be formatted as YYYY-MM-DD
                    data:
                      errors:
                        - path: date
                          message: Date must be formatted as YYYY-MM-DD
                          code: invalid_format
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalError'
        '504':
          $ref: '#/components/responses/Timeout'
components:
  schemas:
    DatahubBuroResponse:
      type: object
      required:
        - data
        - lastUpdate
      properties:
        data:
          oneOf:
            - $ref: '#/components/schemas/DatahubBuroCompanyData'
            - $ref: '#/components/schemas/DatahubBuroPersonData'
            - type: 'null'
          description: >-
            Informe de buró. La forma depende de `isPerson`: empresa o persona.
            `null` si no hay un informe disponible para ese RUT (tu empresa
            nunca lo consultó, el RUT no existe o no se pudo leer en este
            momento). Reintenta antes de asumir que no existe.
        lastUpdate:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Fecha y hora de la última consulta de buró de tu empresa para ese
            RUT (no la de tu solicitud), en ISO 8601. `null` si no hay un
            informe de buró disponible (nunca se consultó o no se pudo leer en
            este momento).
    ValidationError:
      type: object
      required:
        - message
        - displayMessage
        - data
      description: Error de validación del body, de los query params o de los path params.
      properties:
        message:
          type: string
          description: >-
            Código del primer error de validación (por ejemplo `custom`,
            `invalid_type`, `invalid_format`, `invalid_value`, `invalid_union`).
        displayMessage:
          type: string
          description: >-
            Mensaje del primer error de validación, pensado para mostrarlo a una
            persona. Normalmente en español; algunos mensajes de validación
            vienen en inglés.
        data:
          type: object
          required:
            - errors
          properties:
            errors:
              type: array
              description: Todos los errores de validación encontrados.
              items:
                type: object
                required:
                  - path
                  - message
                  - code
                properties:
                  path:
                    type: string
                    description: >-
                      Campo con el error. Para listas incluye la posición, por
                      ejemplo `types.0`. `(root)` si el error es del body
                      completo.
                  message:
                    type: string
                    description: Descripción del error en español.
                  code:
                    type: string
                    description: Código del tipo de error.
    DatahubBuroCompanyData:
      type: object
      description: Informe de buró de una empresa (`isPerson` es `false`).
      required:
        - identifier
        - isPerson
        - companySummary
        - summary
        - tributarySummary
      properties:
        identifier:
          type: string
          description: RUT consultado.
          example: 76111111-6
        isPerson:
          type: boolean
          const: false
          description: Siempre `false` para una empresa.
        companySummary:
          $ref: '#/components/schemas/DatahubBuroCompanySummary'
        summary:
          $ref: '#/components/schemas/DatahubBuroCompanySummaryDebt'
        tributarySummary:
          type: object
          description: Información tributaria y de bienes de la empresa.
          properties:
            realState:
              type: object
              description: Bienes raíces de la empresa.
              properties:
                propertiesCount:
                  type: string
                  description: Cantidad de bienes raíces, como texto.
                  example: '1'
                totalAssesmentAmountPesos:
                  type: string
                  description: Avalúo total de los bienes raíces, en CLP, como texto.
                  example: '150000000'
            vehicles:
              type: array
              description: Detalle de cada vehículo.
              items:
                type: object
                properties:
                  carSerial:
                    type: string
                    description: Número de serie.
                  carValue:
                    type: number
                    description: Valor del vehículo, en CLP.
                  chasisSerial:
                    type: string
                    description: Número de chasis.
                  classificationType:
                    type: object
                    properties:
                      description:
                        type: string
                        description: Clasificación.
                  color:
                    type: object
                    properties:
                      description:
                        type: string
                        description: Color.
                  dateLastTransfer:
                    type: string
                    description: Fecha de la última transferencia, como la informa el buró.
                  fuelDescription:
                    type: string
                    description: Combustible.
                  mark:
                    type: object
                    properties:
                      description:
                        type: string
                        description: Marca.
                  model:
                    type: object
                    properties:
                      description:
                        type: string
                        description: Modelo.
                  motorSerial:
                    type: string
                    description: Número de motor.
                  plate:
                    type: string
                    description: Patente.
                    example: ABCD12
                  type:
                    type: object
                    properties:
                      code:
                        type: string
                        description: Código del tipo.
                      model:
                        type: string
                        description: Modelo del tipo.
                  yearManufacture:
                    type: integer
                    description: Año de fabricación.
            economicActivity:
              type: array
              description: Actividades económicas registradas.
              items:
                $ref: '#/components/schemas/DatahubBuroActivity'
            bankruptciesQuantity:
              type: integer
              description: Cantidad de quiebras registradas.
    DatahubBuroPersonData:
      type: object
      description: >-
        Informe de buró de una persona (`isPerson` es `true`). Contiene datos
        personales.
      required:
        - identifier
        - isPerson
        - identificationDetails
        - debts
        - patrimony
        - tributary
        - consults
      properties:
        identifier:
          type: string
          description: RUT consultado.
          example: 11111111-1
        isPerson:
          type: boolean
          const: true
          description: Siempre `true` para una persona.
        identificationDetails:
          type: object
          description: Datos de identificación de la persona.
          properties:
            name:
              type: string
              description: Nombre completo.
              example: Ana Pérez
            age:
              type: integer
              description: Edad en años.
            Gender:
              type: string
              description: Género, como lo informa el buró.
            death:
              type: boolean
              description: Indica si la persona figura fallecida.
            birthDate:
              type: string
              format: date-time
              description: Fecha de nacimiento (ISO 8601).
            maritalStatus:
              type: string
              description: Estado civil.
            nationality:
              type: string
              description: Nacionalidad.
            addresses:
              type: array
              description: Direcciones conocidas.
              items:
                type: object
                description: >-
                  Dirección tal como la informa el buró. Los campos dependen del
                  proveedor; por ejemplo `StreetAndNumber`, `Communes`, `Region`
                  y `AddressDate` (ISO 8601).
                additionalProperties: true
            phones:
              type: array
              description: Teléfonos conocidos.
              items:
                type: object
                description: >-
                  Teléfono tal como lo informa el buró. Los campos dependen del
                  proveedor; por ejemplo `Telephone`, `SourceOfTelephone` y
                  `TelephoneDate` (ISO 8601).
                additionalProperties: true
            emails:
              type: array
              description: Correos conocidos.
              items:
                type: string
                description: Correo electrónico.
                example: ana@example.com
            other:
              type: object
              description: >-
                Información complementaria del buró. Incluye `DateUpdateIse`
                (ISO 8601 o `null`) y otros campos que dependen del proveedor.
              additionalProperties: true
            salary:
              type:
                - number
                - string
              description: Renta presunta, en CLP.
            profession:
              type: string
              description: Profesión.
        debts:
          $ref: '#/components/schemas/DatahubBuroPersonDebt'
        patrimony:
          type: object
          description: Patrimonio y riesgo de la persona.
          properties:
            societies:
              type: array
              description: Sociedades en las que participa.
              items:
                type: object
                description: Sociedad en que participa, tal como la informa el buró.
                additionalProperties: true
            gse:
              type: string
              description: Grupo socioeconómico.
              example: C1
            detailOrders:
              type: array
              description: Detalle adicional informado por el buró.
              items:
                type: object
                additionalProperties: true
            bankAccounts:
              type: array
              description: Bancos con los que opera.
              items:
                type: object
                properties:
                  bank_name:
                    type: string
                    description: Nombre del banco.
            boletinConcursal:
              type: array
              description: Publicaciones del boletín concursal.
              items:
                type: object
                description: >-
                  Publicación del boletín concursal, tal como la informa el
                  buró.
                additionalProperties: true
            realStateValuation:
              type: number
              description: Avalúo total de bienes raíces, en CLP.
            realStateNumber:
              type: integer
              description: Cantidad de bienes raíces.
            vehiclesNumber:
              type: integer
              description: Cantidad de vehículos.
            vehiclesValuation:
              type: number
              description: Valor de los vehículos, en CLP.
            riskScore:
              $ref: '#/components/schemas/DatahubBuroRiskScore'
            everclean:
              type: string
              description: '`1` si la persona no registra morosidades históricas.'
              example: '1'
            consultsByOthers:
              type: array
              description: 'Reservado: no uses este campo. Usa `consults.historic`.'
              items:
                type: object
        tributary:
          type: object
          description: Información tributaria.
          properties:
            economicCode:
              type: string
              description: Código de la actividad económica.
            economicActivity:
              type: string
              description: Actividad económica.
            observations:
              type: integer
              description: Cantidad de observaciones tributarias.
        consults:
          type: object
          description: Consultas de terceros.
          properties:
            historic:
              type: array
              description: Consultas que otras empresas hicieron sobre el RUT.
              items:
                $ref: '#/components/schemas/DatahubBuroConsultEntry'
            count:
              type: integer
              description: Cantidad total de consultas.
    Error:
      type: object
      required:
        - message
      properties:
        message:
          type: string
          description: >-
            Identifica el error. En algunos casos es un texto en inglés con
            valores variables. Para tu lógica, usa el código HTTP y, cuando
            exista, `data.code`.
        displayMessage:
          type: string
          description: >-
            Mensaje pensado para mostrarlo a una persona. Normalmente en
            español; algunos mensajes de validación vienen en inglés.
        data:
          description: Detalle adicional del error, cuando existe.
    DatahubBuroCompanySummary:
      type: object
      description: Datos generales de la empresa.
      properties:
        businessName:
          type: string
          description: Razón social.
          example: Cliente Ejemplo SpA
        startDate:
          type:
            - string
            - 'null'
          format: date-time
          description: Fecha de inicio de actividades (ISO 8601). `null` si no se conoce.
        email:
          type: string
          description: Correo de contacto principal.
          example: contacto@example.com
        address:
          type: object
          description: Dirección comercial principal, tal como la informa el buró.
          properties:
            addressDate:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            addressType:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            addressUpdateDate:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            aditionalInfo:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            city:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            codeRegion:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            communes:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            lastAddressVerificationDate:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            number:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            postalCode:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            region:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            sourceOfAddress:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            street:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
            streetAndNumber:
              type: string
              description: Dato de la dirección tal como lo informa el buró.
        phones:
          type: array
          description: Teléfonos de referencia.
          items:
            type: object
            properties:
              codCountry:
                type: string
                description: Dato del teléfono tal como lo informa el buró.
              codeArea:
                type: string
                description: Dato del teléfono tal como lo informa el buró.
              descInfoSource:
                type: string
                description: Dato del teléfono tal como lo informa el buró.
              lastUpdate:
                type: string
                description: Dato del teléfono tal como lo informa el buró.
              numCountry:
                type: string
                description: Dato del teléfono tal como lo informa el buró.
              referencyDesc:
                type: string
                description: Dato del teléfono tal como lo informa el buró.
              referencyDescSubType:
                type: string
                description: Dato del teléfono tal como lo informa el buró.
              validationDate:
                type: string
                description: Dato del teléfono tal como lo informa el buró.
        totalConsults:
          type: integer
          description: >-
            Cantidad total de consultas que otras empresas hicieron sobre el
            RUT.
        companySize:
          type: string
          description: Tramo de tamaño de la empresa.
          example: MEDIANA
        collaborators:
          type: integer
          description: Cantidad de trabajadores.
        bankAccounts:
          type: array
          description: Bancos con los que opera la empresa.
          items:
            type: object
            properties:
              bank_name:
                type: string
                description: Nombre del banco.
                example: BANCO EJEMPLO
        executives:
          type: array
          description: Ejecutivos de la empresa.
          items:
            type: object
            properties:
              name:
                type: string
                description: Nombre.
              fatherSurname:
                type: string
                description: Apellido paterno.
              motherSurname:
                type: string
                description: Apellido materno.
              rut:
                type: string
                description: RUT del ejecutivo.
              roleDescription:
                type: string
                description: Cargo.
                example: GERENTE GENERAL
              email:
                type: string
                description: Correo.
              phoneNumber:
                type: string
                description: Teléfono.
              dateOfExecutiveNomination:
                type: string
                description: Fecha de nombramiento, como la informa el buró.
              executiveInformationDate:
                type: string
                format: date-time
                description: Fecha de la información (ISO 8601).
        mainPartners:
          type: array
          description: Empresas en las que participa la empresa consultada.
          items:
            type: object
            properties:
              businessName:
                type: string
                description: Razón social de la empresa en que participa.
              rutOfTheCompany:
                type: string
                description: RUT de esa empresa.
              partnerCount:
                type: integer
                description: Cantidad de socios.
              partnershipCount:
                type: integer
                description: Cantidad de sociedades.
        relatedPartners:
          type: array
          description: Socios relacionados.
          items:
            type: object
            properties:
              namePartner:
                type: string
                description: Nombre del socio.
              rutPartner:
                type: string
                description: RUT del socio.
              partnerCount:
                type: integer
                description: Cantidad de socios.
              partnershipCount:
                type: integer
                description: Cantidad de sociedades del socio.
        everclean:
          type: string
          description: '`1` si la empresa no registra morosidades históricas.'
          example: '0'
        consultsByOthers:
          type: array
          description: Consultas que otras empresas hicieron sobre el RUT.
          items:
            $ref: '#/components/schemas/DatahubBuroConsultEntry'
        activities:
          type: array
          description: Giros de la empresa.
          items:
            $ref: '#/components/schemas/DatahubBuroActivity'
    DatahubBuroCompanySummaryDebt:
      type: object
      description: Resumen de morosidad, puntaje de riesgo y bienes de la empresa.
      required:
        - debt
        - riskScore
      properties:
        debt:
          $ref: '#/components/schemas/DatahubBuroCompanyDebt'
        accreditationsFlag:
          type:
            - boolean
            - string
          description: Indicador de acreditaciones informado por el buró.
        realStateValuation:
          type:
            - number
            - string
          description: >-
            No es confiable: no lo uses. Para bienes raíces usa
            `tributarySummary.realState`.
        realStateNumber:
          type:
            - number
            - string
          description: >-
            No es confiable: no lo uses. Para bienes raíces usa
            `tributarySummary.realState`.
        vehiclesValuatio:
          type: number
          description: >-
            Valor aproximado de los vehículos de la empresa, en CLP. El nombre
            del campo se entrega sin la última letra, tal como se muestra aquí.
        vehiclesNumber:
          type: integer
          description: Cantidad de vehículos.
        riskScore:
          $ref: '#/components/schemas/DatahubBuroRiskScore'
    DatahubBuroActivity:
      type: object
      properties:
        activityCode:
          type: string
          description: Código de la actividad económica.
          example: '620100'
        description:
          type: string
          description: Descripción de la actividad.
          example: ACTIVIDADES DE PROGRAMACION INFORMATICA
    DatahubBuroPersonDebt:
      type: object
      description: Sección de morosidad de una persona.
      required:
        - summary
        - accessCamaraComercio
        - totalMultaeInfraccionLaboralPrevisional
        - total
        - boled
        - bolcom
        - bolab
        - icom
        - protests
        - dued
      properties:
        summary:
          type: object
          description: Morosidad acumulada por antigüedad.
          required:
            - docsAmountLast6
            - docsAmountLast12
            - docsAmountLast24
            - docsAmountMoreThan24
          properties:
            docsAmountLast6:
              type: number
              description: >-
                Monto de documentos morosos acumulado en los últimos 6 meses, en
                CLP. Las ventanas de 6, 12 y 24 meses se solapan.
            docsAmountLast12:
              type: number
              description: Monto acumulado en los últimos 12 meses, en CLP.
            docsAmountLast24:
              type: number
              description: Monto acumulado en los últimos 24 meses, en CLP.
            docsAmountMoreThan24:
              type: number
              description: Monto acumulado de más de 24 meses, en CLP.
        accessCamaraComercio:
          type: boolean
          description: >-
            Indica si el informe tuvo acceso a la información de la Cámara de
            Comercio.
        totalMultaeInfraccionLaboralPrevisional:
          type: number
          description: Total de multas e infracciones laborales y previsionales, en CLP.
        total:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtTotal'
          description: >-
            Reservado: no uses este campo. Para obtener el total suma las
            categorías `boled`, `bolcom`, `bolab` e `icom`.
        boled:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtCategory'
          description: Boletín electrónico de deudas (DICOM).
        bolcom:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtCategory'
          description: Boletín comercial.
        bolab:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtCategory'
          description: Boletín laboral.
        icom:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtCategory'
          description: 'Información comercial: morosidades informadas por empresas.'
        protests:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroProtests'
          description: Protestos.
        dued:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtTotal'
          description: 'Deudas vencidas: monto y cantidad de documentos.'
    DatahubBuroRiskScore:
      type: object
      required:
        - score
        - historicalRate
      properties:
        score:
          type: string
          description: >-
            Puntaje de riesgo actual, escrito como texto. `0` si el buró no lo
            informa.
          example: '850'
        historicalRate:
          type: array
          description: Puntaje de los últimos 12 períodos, del más reciente al más antiguo.
          items:
            type: object
            required:
              - name
              - value
            properties:
              name:
                type: string
                description: Período, con el formato `AAAA-MM`.
                example: 2026-09
              value:
                type: string
                description: Puntaje del período.
                example: '850'
    DatahubBuroConsultEntry:
      type: object
      description: Consulta que otra empresa hizo sobre el RUT.
      required:
        - businessName
        - report
        - date
      properties:
        businessName:
          type: string
          description: Empresa que hizo la consulta.
          example: Factoring Consultante SpA
        report:
          type: string
          description: Tipo de informe consultado.
          example: INFORME COMERCIAL
        date:
          type: string
          format: date-time
          description: Fecha de la consulta (ISO 8601).
    DatahubBuroCompanyDebt:
      type: object
      description: Sección de morosidad de una empresa.
      required:
        - accessCamaraComercio
        - totalMultaeInfraccionLaboralPrevisional
        - total
        - boled
        - bolcom
        - bolab
        - icom
        - protests
        - dued
      properties:
        accessCamaraComercio:
          type: boolean
          description: >-
            Indica si el informe tuvo acceso a la información de la Cámara de
            Comercio.
        totalMultaeInfraccionLaboralPrevisional:
          type: number
          description: Total de multas e infracciones laborales y previsionales, en CLP.
        total:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtTotal'
          description: >-
            Reservado: no uses este campo. Para obtener el total suma las
            categorías `boled`, `bolcom`, `bolab` e `icom`.
        boled:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtCategory'
          description: Boletín electrónico de deudas (DICOM).
        bolcom:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtCategory'
          description: Boletín comercial.
        bolab:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtCategory'
          description: Boletín laboral.
        icom:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtCategory'
          description: 'Información comercial: morosidades informadas por empresas.'
        protests:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroProtests'
          description: Protestos.
        dued:
          allOf:
            - $ref: '#/components/schemas/DatahubBuroDebtTotal'
          description: 'Deudas vencidas: monto y cantidad de documentos.'
    DatahubBuroDebtTotal:
      type: object
      required:
        - amount
        - document
      properties:
        amount:
          type: number
          description: Monto, en CLP.
        document:
          type: integer
          description: Cantidad de documentos.
    DatahubBuroDebtCategory:
      type: object
      required:
        - amount
        - documentCount
        - documents
      properties:
        amount:
          type: number
          description: Monto total impago de la categoría, en CLP.
        documentCount:
          type: integer
          description: Cantidad de documentos de la categoría.
        documents:
          type: array
          description: Detalle de cada documento.
          items:
            $ref: '#/components/schemas/DatahubBuroDebtDocument'
    DatahubBuroProtests:
      type: object
      required:
        - amount
        - documentCount
        - documents
      properties:
        amount:
          type: number
          description: Monto total de protestos, en CLP.
        documentCount:
          type: integer
          description: Cantidad de protestos.
        documents:
          type: array
          description: 'Reservado: no uses este campo. Usa `amount` y `documentCount`.'
          items:
            type: object
    DatahubBuroDebtDocument:
      type: object
      description: >-
        Detalle de un documento moroso tal como lo informa el buró. Los campos
        dependen del tipo de boletín: los que se listan son los más comunes y
        pueden venir otros.
      properties:
        documentType:
          type: string
          description: Tipo de documento (por ejemplo `LETRA`, `CUOTA`).
          example: LETRA
        libradorName:
          type: string
          description: Nombre de quien libró el documento o acreedor.
          example: ACREEDOR SPA
        unpaidAmount:
          type:
            - string
            - number
          description: Monto impago del documento.
          example: '1250000'
        moneyCode:
          type: string
          description: Código de la moneda del monto impago.
        justificationDescription:
          type: string
          description: Descripción de la justificación informada, cuando existe.
        registerDate:
          type:
            - string
            - 'null'
          format: date-time
          description: Fecha de registro del documento (ISO 8601). `null` si no viene.
        equifaxRegisterDate:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Fecha en que el buró registró el documento (ISO 8601). `null` si no
            viene.
        justificationDate:
          type:
            - string
            - 'null'
          format: date-time
          description: Fecha de la justificación (ISO 8601). `null` si no hay.
        expirationDate:
          type:
            - string
            - 'null'
          format: date-time
          description: Fecha de vencimiento del documento (ISO 8601). `null` si no viene.
        visibilityDate:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Fecha hasta la que el documento es visible en el buró (ISO 8601).
            `null` si no viene.
      additionalProperties: true
  responses:
    Unauthorized:
      description: >-
        Falta el header `x-api-key`, su valor no es válido o la cuenta de API de
        tu empresa no está habilitada.
      content:
        application/json:
          schema:
            type: object
            required:
              - message
            properties:
              message:
                type: string
          example:
            message: 'Unauthorized: Invalid API Key'
    TooManyRequests:
      description: >-
        Tu empresa superó el límite de solicitudes. Todas las API keys de tu
        empresa comparten el mismo límite. Espera los segundos que indica el
        header `Retry-After` (o `data.retryAfterSeconds`) antes de reintentar.
      headers:
        Retry-After:
          description: Segundos que debes esperar antes de reintentar.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: >-
              Rate limit exceeded: 501 requests in the current 60s window, limit
              is 500. Retry in 12s.
            displayMessage: >-
              Superaste el límite de 500 solicitudes cada 60 segundos. Vuelve a
              intentarlo en 12 segundos.
            data:
              code: RATE_LIMIT_EXCEEDED
              scope: All API keys of your company share this budget.
              limit: 500
              used: 501
              windowSeconds: 60
              retryAfterSeconds: 12
              resetAt: '2026-11-04T15:00:12.000Z'
              hint: >-
                Wait until resetAt (or honor the Retry-After header) before
                retrying. Avoid repeating identical requests: reuse responses
                you already fetched, use filters and larger pageSize values
                instead of one request per item, and cap your client
                concurrency.
    InternalError:
      description: >-
        Error inesperado en Pruff. El texto de `message` puede variar (por
        ejemplo en mayúsculas); no dependas de él.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: Internal server error
    Timeout:
      description: >-
        La solicitud superó el tiempo máximo de 55 segundos. La operación puede
        haberse completado igual: antes de reintentar una solicitud que crea o
        modifica datos, verifica su estado.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: request_timeout
            displayMessage: La solicitud excedió el tiempo máximo permitido
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key que Pruff entrega a tu empresa.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.