Consulta de consentimientos

Consultar qué consintió una persona

Changed on

Devuelve, por cada uso de datos del que la persona tiene registro, qué versión aceptó, cuál está vigente y en qué estado queda la combinación. La organización lo llama desde su servidor, antes de anunciar un consentimiento, para no volver a pedir lo que ya está active o pedir sólo lo que quedó outdated.

Una persona sin registros responde 200 con una lista vacía, no un 404: que no haya consentido nada es una respuesta. La lista no se pagina, porque una persona tiene a lo sumo una fila por uso de datos.

Editar el enunciado de un uso de datos no desactualiza nada: sólo una versión nueva lo hace, así que quien aceptó la frase anterior sigue saliendo active.

external_id tiene que ser opaco. Viaja en la URL, así que queda en los logs de las requests por debajo de cualquier filtro: no uses ahí un correo, un RUT ni ningún otro dato de la persona. Por la misma razón esta ruta no recibe un documento de identidad.

Límite de tasa: 20 solicitudes por segundo. Al superarlo, la API responde 429. Ver Límites de tasa.

get/consent/consents

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/consent/consents
  • Auth
    API key in header x-api-key

Query parameters

external_idstring required

Identificador de la persona en los sistemas de la organización, el mismo con el que la anunció. Tiene que ser opaco: nunca un correo ni un RUT.

Example:cliente-4471

Response

Successful Response

granted_atstring date-time required

Momento de la aceptación que rige, en UTC.

revoked_atstring date-time nullable

Momento del retiro, si lo hubo, en UTC.

status'active' | 'outdated' | 'revoked' required

What the API answers and filters by. outdated is never stored — it is a comparison against the version in force, made when the row is read.

Example response

[
  {
    "document": {
      "current_version": 2,
      "name": "Términos y condiciones para el flujo de pago",
      "uuid": "8f14e45f-ceea-467a-9f39-1c4b2f7a0d31",
      "version": 1
    },
    "granted_at": "2026-04-23T09:42:02Z"
  }
]

Changes