Entity

Los objetos de Entidad permiten asociar los consentimientos de tus usuarios a un objeto. Una entidad representa a un usuario no verificado en el sistema, a diferencia de una identidad.

idstring

ID único de la entidad.

Example: ent_1B2M2Y8AsgTpgAmY7PhCfg

agreement_idstring

ID del agreement asociado a la entidad.

Example: agr_1B2M2Y8AsgTpgAmY7PhCfg

identity_idstringnullable

ID de la identidad asociada a la entidad. Solo presente cuando la entidad tiene una identidad asociada.

Example: id_1B2M2Y8AsgTpgAmY7PhCfg

user_referencestringnullable

Referencia del usuario en tu sistema, almacenada directamente en la entidad (no depende del último agreement).

Example: user_123

created_atstring<date-time>

Fecha y hora de creación de la entidad.

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

updated_atstring<date-time>

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

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

attestations object[]

Lista de attestations que documentan las validaciones realizadas sobre esta entidad.

Array [

kindstring

Tipo de attestation que certifica una validación específica:

liveness: Certifica que se realizó una prueba de vida (detección de persona real)
id_scan: Certifica que se escaneó y validó un documento de identidad
id_match: Certifica que se comparó la foto del documento con la imagen de la persona (coincidencia facial)
government_check: Certifica que se validó la información con registros gubernamentales

Possible values: [liveness, id_scan, id_match, government_check]

Example: liveness

validated_atstring<date-time>

Fecha y hora en que se realizó la validación certificada por este attestation

Example: 2026-01-19T12:00:00Z

]

Entity
{
  "id": "ent_1B2M2Y8AsgTpgAmY7PhCfg",
  "agreement_id": "agr_1B2M2Y8AsgTpgAmY7PhCfg",
  "identity_id": "id_1B2M2Y8AsgTpgAmY7PhCfg",
  "user_reference": "user_123",
  "created_at": "2024-03-20T15:30:00Z",
  "updated_at": "2024-03-20T15:30:00Z",
  "attestations": [
    {
      "kind": "liveness",
      "validated_at": "2026-01-19T12:00:00Z"
    },
    {
      "kind": "id_scan",
      "validated_at": "2026-01-19T12:00:00Z"
    },
    {
      "kind": "government_check",
      "validated_at": "2026-01-19T12:05:00Z"
    }
  ]
}