Consultar qué consintió una persona
Changed onDevuelve, 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.
Request
- Base URLhttps://api.trytoku.com
- URLhttps://api.trytoku.com/consent/consents
- AuthAPI key in header x-api-key
Query parameters
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.
Response
Successful Response
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
- info
endpoint added
- info