Listar Consentimientos

POST /cl/consent_manager/list_consents

Obtiene un listado paginado de consentimientos con filtros opcionales.

URL Completa: https://api.floid.app/cl/consent_manager/list_consents

Parámetros de Entrada

Parámetro	Tipo	Requerido	Descripción
`caseId`	string	No	ID único del caso para trazabilidad
`consent_token`	string	No	ID único del caso para trazabilidad
`page`	integer	No	Número de página (default: 1)
`limit`	integer	No	Registros por página (default: 50, max: 500)
`person_rut`	string	No	Filtrar por RUT de persona
`codigo_institucion`	string	No	Filtrar por código de institución
`estado`	string	No	Filtrar por estado: ACTIVE, REVOKED, EXPIRED
`finalidad`	integer	No	Filtrar por finalidad (1 o 2)
`fecha_desde`	string	No	Fecha inicio (formato: YYYY-MM-DD)
`fecha_hasta`	string	No	Fecha fin (formato: YYYY-MM-DD)
`custom_id`	string	No	Filtrar por custom_id exacto
`codigo_interno_consentimiento`	string	No	Filtrar por codigo interno
`evidence_hash`	string	No	Filtrar por hash de evidencia

Ejemplo de Solicitud

curl --location 'https://api.floid.app/cl/consent_manager/list_consents
--header 'Authorization: Bearer {{TOKEN}}' \
--data '{
 	"consent_token": "a9a628a1-b4ac-4ab2-b4d0-954f91239d60",
}'

Respuesta Exitosa (200)

{
  "code": "200",
  "msg": "OK",
  "caseid": "CASE-123456",
  "data": {
    "consents": [
      {
        "id": 501,
        "id_cliente": 10,
        "is_sandbox": 0,
        "consent_token": "b9c2d0d3-7c4f-4e0a-9d3c-9e9c1f3a1234",
        "codigo_institucion": "987654321",
        "codigo_interno_consentimiento": "CONS-INT-001",
        "tipo_consentimiento": null,
        "timestamp_otorgamiento_fecha": "20260115",
        "timestamp_otorgamiento_hora": "103015",
        "timestamp_expiracion_fecha": "20270115",
        "timestamp_expiracion_hora": "103015",
        "person_rut": "12345678-5",
        "tipo_persona": "NATURAL",
        "tiene_apoderado": "NO",
        "persona_juridica_json": null,
        "apoderados_json": null,
        "medio": 1,
        "finalidad": 2,
        "rut_ejecutivo": "11222333-4",
        "objetivo": "01",
        "person_email": "[email protected]",
        "person_birthdate": "1985-06-10",
        "person_cellphone": "56998765432",
        "rut_empresa": "76543210-1",
        "timestamp_revocacion_fecha": null,
        "timestamp_revocacion_hora": null,
        "timestamp_carga": "2026-01-15 10:30:15",
        "uploaded_by": "API",
        "person_name": "CARLOS GONZALEZ",
        "person_apellido": "GONZALEZ",
        "sucursal": "SUC-01",
        "ubicacion": "Santiago",
        "ip": "192.168.10.25",
        "navegador": "Chrome",
        "version_tc": "v2.1",
        "widget_id": 15,
        "tc_version_id": 4,
        "version": 1,
        "parent_consent_id": null,
        "meta_attachment": null,
        "created_by": "API",
        "last_updated_at": "2026-01-15 10:30:15",
        "last_updated_by": "API",
        "timestamp_expires_at_fecha": "20270115",
        "timestamp_expires_at_hora": "103015",
        "metadata_json": null,
        "evidence_url": "https://storage.example.com/evidence/consent_501.pdf",
        "evidence_hash": "b1946ac92492d2347c6235b4d2611184",
        "evidence_file_format": "PDF",
        "evidence_storage_mode": "GCS",
        "evidence_gcs_path": "consents/evidence/consent_501.pdf",
        "evidence_file_size_bytes": 245678,
        "evidence_status": "AVAILABLE",
        "evidence_error": null,
        "fingerprint_hash": "c5e478d59288c841aa530db6845c4c8d",
        "codigo_encriptado_consentimiento": "ENC-XYZ-123456",
        "fecha_revocado_redec": null,
        "estado": "ACTIVE",
        "custom_id": "CONSENT-DEMO-001"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total_records": 1,
      "total_pages": 1,
      "has_next": false,
      "has_prev": false
    },
    "filters_applied": {
      "consent_token": "b9c2d0d3-7c4f-4e0a-9d3c-9e9c1f3a1234",
      "limit": 50,
      "offset": 0,
      "order_by": "timestamp_carga",
      "order_direction": "DESC"
    }
  }
}

Posibles Errores

Error Code	HTTP	Descripción
`INVALID_REQUEST`	400	Parámetro de filtro inválido
`INVALID_REQUEST`	400	Límite excede máximo de 500
`INVALID_REQUEST`	400	Formato de fecha inválido
`INTERNAL_ERROR`	400	Error al consultar base de datos
`INVALID_DATE_RANGE`	400	Fecha desde es posterior a fecha hasta
`LIMIT_EXCEEDED`	400	Límite de paginación excede 500
`NO_RECORDS`	400	No hay registros para exportar