DataSubjectRequest

Representan las solicitudes de ejercicio de derechos de los usuarios.

Guías relacionadas

idstring

Identificador único del data subject request. Debe empezar con dsreq_

Example: dsreq_1B2M2Y8AsgTpgAmY7PhCfg

humanized_identifierstring

Identificador de la solicitud.

Example: FME4607

subject_idstring

Identificador único del sujeto de datos que se está modificando. Puede corresponder al identificador de un Identity o Entity.

Example: ent_1B2M2Y8AsgTpgAmY7PhCfg

user_referencestring

Referencia del usuario en el sistema del cliente.

Example: user_123

request_referencestring

Referencia opcional de la solicitud proporcionada por el cliente para correlacionar webhooks y eventos.

Example: ticket-12345

company_branch_idstring

Identificador de la sucursal a la que está asociada esta solicitud.

Example: branch_1B2M2Y8AsgTpgAmY7PhCfg

kindstringrequired

Tipo de solicitud.

Possible values: [access, rectification, opposition, suppression, portability, redec_update, redec_rectification, redec_complementation, redec_cancellation]

Example: access

statusstring

Estado actual de la solicitud.

Possible values: [awaiting_verification, validating, processing, resolved, data_missmatch, timed_out]

Example: awaiting_verification

terminal_statestring

Estado terminal de la solicitud cuando status es resolved.

Possible values: [approved, partially_approved, rejected]

Example: approved

approvedbooleandeprecated

Indica si la resolución fue aprobada (true) o rechazada (false). Campo legacy derivado de terminal_state y puede ser null si la resolución es parcial.

Example: true

data_usage_during_requeststring

Indica si el uso de datos durante la solicitud está permitido o no. Solo es requerido para las solicitudes de tipo rectification, opposition y suppression.

Possible values: [block, allow]

Example: block

data_usage_block_justificationstring

Justificación que el titular puede proveer cuando elige bloquear el uso de sus datos durante la solicitud (data_usage_during_request: "block"). Es opcional por defecto, pero pasa a ser obligatoria si la configuración data_usage_block_justification_required está activada.

Example: El procesamiento de mis datos me está afectando mientras se resuelve la solicitud.

rejection_reasonstring

Razón de rechazo si la solicitud fue rechazada.

Example: Documentación insuficiente

contact_information objectrequired

Información de contacto del titular. La visibilidad / obligatoriedad de alguno de estos campos es configurable.

ninstringrequired

Número de identificación del usuario. No configurable.

Example: 123456789

emailemailrequired

Email del usuario. Este email se usa para enviar confirmaciones. No configurable.

Example: user@example.com

namesstring

Nombres del usuario. Configurable

Possible values: <= 50 characters

Example: Juan Carlos

last_namesstring

Apellidos del usuario. Configurable

Possible values: <= 50 characters

Example: Pérez Gómez

phonestring

Número de teléfono del usuario. Configurable

Example: +56 9 1234 5678

request_detail objectnullable

Detalle de la solicitud. Puede ser null cuando la solicitud es creada directamente por la compañía (a través de la API). Cuando se crea a través del widget del centro de privacidad, este campo siempre estará presente.

oneOf

DSRQueryRequestDetail
DSRMutationRequestDetail
DSRRedecRequestDetail

kindstringrequired

Tipo de solicitud de consulta.

Possible values: [all, specific]

Example: all

data_categoriesstring[]

Categorías de datos a solicitar. Requerido cuando kind es 'specific'. Debe ser una categoría válida de la taxonomía o 'other'.

Example: ["user.name","user.contact.email"]

detailstring

Detalle adicional de la solicitud.

Example: Solicitud de acceso a datos personales

requested_fields object[]required

Campos específicos que se solicita modificar

Possible values: >= 1

Array [

data_categorystringrequired

Categoría de datos según taxonomía válida o 'all'. Debe ser una categoría válida de la taxonomía.

Example: user.name

detailstringrequired

Detalle específico del campo solicitado.

Example: Corrección de fecha de nacimiento

file_data object

Datos del archivo adjunto (si aplica). Los archivos deben enviarse en formato data_uri (data:<mime>;base64,<payload>) y pueden ser PDF o imágenes (JPG/PNG) con un tamaño máximo de 5 MB.

property name*any

Datos del archivo adjunto (si aplica). Los archivos deben enviarse en formato data_uri (data:<mime>;base64,<payload>) y pueden ser PDF o imágenes (JPG/PNG) con un tamaño máximo de 5 MB.

]

redec_idstring

Identificador del caso en REDEC.

Example: redec_123

reason_codeintegerrequired

Código de razón definido por REDEC. Debe ser válido para el tipo de solicitud REDEC.

Example: 2

entry_channel_codeinteger

Código de la vía de ingreso de la solicitud.

Example: 11

reasonstring

Texto asociado al código de razón. Solo de respuesta.

Example: Diferencias en la morosidad informada de la deuda objetada

detailstringrequired

Detalle adicional de la solicitud.

Example: Actualización de monto informado

operation_idstringrequired

Código de la operación crediticia asociada a la solicitud.

Example: op_123456

file_urlstringnullable

URL del archivo adjunto (PDF), si aplica.

has_validation_attemptboolean

Indica si la solicitud tiene un intento de validación activo o histórico.

Example: true

validation_sourcestring

Origen de la validación de identidad del titular. soyio cuando existe al menos un intento de validación trazable; external cuando la solicitud avanzó a processing/resolved sin ningún intento (se validó fuera del producto); pending cuando la solicitud sigue abierta y aún no se valida.

Possible values: [soyio, external, pending]

Example: soyio

authentication_metadata object | null

Metadata libre que el cliente registra sobre cómo autenticó al titular cuando la validación fue externa (modo autenticado). El esquema lo define el cliente. null cuando no aplica.

property name*anynullable

Metadata libre que el cliente registra sobre cómo autenticó al titular cuando la validación fue externa (modo autenticado). El esquema lo define el cliente. null cuando no aplica.

Example: {"method":"oauth2","provider":"Auth0","authenticated_at":"2026-06-08T10:30:00Z"}

identity_verification_typeIdentityVerificationType

Tipo semántico de validación de identidad configurado para el intento.

Possible values: [biometric, document_scan, government_check, biometric_with_government_check, document_scan_with_government_check, unknown]

Example: biometric_with_government_check

validation_attempt object

Resumen no sensible del intento de validación más reciente (excluye intentos cancelados).

oneOf

DSRValidationAttemptSummary
MOD2

idstring

ID del intento de validación.

Example: va_1B2M2Y8AsgTpgAmY7PhCfg

statusstring

Estado del intento de validación.

Possible values: [pending, in_progress, successful, failed, canceled]

Example: successful

identity_verification_typeIdentityVerificationType

Tipo semántico de validación de identidad configurado para el intento.

Possible values: [biometric, document_scan, government_check, biometric_with_government_check, document_scan_with_government_check, unknown]

Example: biometric_with_government_check

successful_atdate-timenullable

Fecha en que el intento fue exitoso, si aplica.

error_reasonstring | nullnullable

Motivo del error del intento, si falló.

Example: matcher_error

created_atdate-time

Fecha de creación del intento.

government_id_validation object

oneOf

GovernmentIdValidationSummary
MOD2

statusstring

Estado de la validación gubernamental.

Possible values: [pending, in_progress, verified, failed]

Example: verified

government_check_providerstring | nullnullable

Proveedor usado para la validación gubernamental.

Example: certificadora_del_sur

error_reasonstring | nullnullable

Motivo del error si la validación gubernamental falló.

Example: document_not_valid

validation_attempts object[]

Intentos de validación con Soyio en orden cronológico (excluye los cancelados). Vacío cuando la validación fue externa.

Array [

idstring

ID del intento de validación.

Example: va_1B2M2Y8AsgTpgAmY7PhCfg

statusstring

Estado del intento de validación.

Possible values: [pending, in_progress, successful, failed, canceled]

Example: successful

identity_verification_typeIdentityVerificationType

Tipo semántico de validación de identidad configurado para el intento.

Possible values: [biometric, document_scan, government_check, biometric_with_government_check, document_scan_with_government_check, unknown]

Example: biometric_with_government_check

successful_atdate-timenullable

Fecha en que el intento fue exitoso, si aplica.

error_reasonstring | nullnullable

Motivo del error del intento, si falló.

Example: matcher_error

created_atdate-time

Fecha de creación del intento.

government_id_validation object

oneOf

GovernmentIdValidationSummary
MOD2

statusstring

Estado de la validación gubernamental.

Possible values: [pending, in_progress, verified, failed]

Example: verified

government_check_providerstring | nullnullable

Proveedor usado para la validación gubernamental.

Example: certificadora_del_sur

error_reasonstring | nullnullable

Motivo del error si la validación gubernamental falló.

Example: document_not_valid

]

workflow_run_idstring

ID del workflow run asociado a la solicitud.

Example: wfr_1B2M2Y8AsgTpgAmY7PhCfg

expires_atdate-time

Fecha y hora de expiración de la solicitud.

Example: 2024-03-20T15:30:00Z

created_atdate-time

Fecha y hora de creación de la solicitud.

Example: 2024-03-20T15:30:00Z

updated_atdate-time

Fecha y hora de la última actualización de la solicitud.

Example: 2024-03-20T15:30:00Z

DataSubjectRequest
{
  "id": "dsreq_1B2M2Y8AsgTpgAmY7PhCfg",
  "humanized_identifier": "FME4607",
  "subject_id": "ent_1B2M2Y8AsgTpgAmY7PhCfg",
  "user_reference": "user_123",
  "request_reference": "ticket-12345",
  "company_branch_id": "branch_1B2M2Y8AsgTpgAmY7PhCfg",
  "kind": "access",
  "status": "awaiting_verification",
  "terminal_state": "approved",
  "data_usage_during_request": "block",
  "data_usage_block_justification": "El procesamiento de mis datos me está afectando mientras se resuelve la solicitud.",
  "rejection_reason": "Documentación insuficiente",
  "contact_information": {
    "nin": "123456789",
    "email": "user@example.com",
    "names": "Juan Carlos",
    "last_names": "Pérez Gómez",
    "phone": "+56 9 1234 5678"
  },
  "request_detail": {
    "kind": "all",
    "data_categories": [
      "user.name",
      "user.contact.email"
    ],
    "detail": "Solicitud de acceso a datos personales"
  },
  "has_validation_attempt": true,
  "validation_source": "soyio",
  "authentication_metadata": {
    "method": "oauth2",
    "provider": "Auth0",
    "authenticated_at": "2026-06-08T10:30:00Z"
  },
  "identity_verification_type": "biometric_with_government_check",
  "validation_attempt": {
    "id": "va_1B2M2Y8AsgTpgAmY7PhCfg",
    "status": "successful",
    "identity_verification_type": "biometric_with_government_check",
    "successful_at": "2024-07-29T15:51:28.071Z",
    "error_reason": "matcher_error",
    "created_at": "2024-07-29T15:51:28.071Z",
    "government_id_validation": {
      "status": "verified",
      "government_check_provider": "certificadora_del_sur",
      "error_reason": "document_not_valid"
    }
  },
  "validation_attempts": [
    {
      "id": "va_1B2M2Y8AsgTpgAmY7PhCfg",
      "status": "successful",
      "identity_verification_type": "biometric_with_government_check",
      "successful_at": "2024-07-29T15:51:28.071Z",
      "error_reason": "matcher_error",
      "created_at": "2024-07-29T15:51:28.071Z",
      "government_id_validation": {
        "status": "verified",
        "government_check_provider": "certificadora_del_sur",
        "error_reason": "document_not_valid"
      }
    }
  ],
  "workflow_run_id": "wfr_1B2M2Y8AsgTpgAmY7PhCfg",
  "expires_at": "2024-03-20T15:30:00Z",
  "created_at": "2024-03-20T15:30:00Z",
  "updated_at": "2024-03-20T15:30:00Z"
}

DataSubjectRequest

Guías relacionadas​

Guías relacionadas