Skip to main content
GET
/
api
/
kyc
/
biometric
/
entities
/
{entityId}
/
current
Obtener sesión biométrica actual
curl --request GET \
  --url http://api.gu1.ai/api/kyc/biometric/entities/{entityId}/current \
  --header 'Authorization: Bearer <token>'

​
Descripción general

Este endpoint devuelve la sesión biométrica más reciente de una entidad (ordenada por createdAt), sin importar el estado: pending, in_progress, approved, rejected, etc. Es el equivalente biométrico de GET /api/kyc/entities/{entityId}/current para validaciones KYC.
Si la entidad nunca tuvo una sesión biométrica, la API responde 200 con null (no 404), igual que el endpoint KYC actual.

​
Cuándo usarlo

  • Recuperar una sesión pendiente para embeber de nuevo el sessionUrl o cancelarla
  • Consultar el estado del último intento biométrico (status, rejectionCode, decision)
  • Resolver ACTIVE_SESSION_EXISTS al crear una nueva sesión: el id de la sesión activa está en este endpoint (o en activeSessionId del error 409)

​
Solicitud

GET https://api.gu1.ai/api/kyc/biometric/entities/{entityId}/current

​
Encabezados

{
  "Authorization": "Bearer TU_API_KEY",
  "X-Organization-ID": "uuid-de-tu-organizacion"
}

​
Respuesta

​
200 OK — sesión encontrada

{
  "id": "7618e10c-b1b1-408b-b361-1901077ced73",
  "entityId": "c16b457b-500a-4250-aefe-6d69bdf71fb2",
  "organizationId": "org-uuid",
  "status": "pending",
  "mode": "face_match",
  "sessionUrl": "https://kyc.example.com/session/abc123",
  "hostedSessionId": "e291f904-9c3f-490e-a51e-73434a14ba9a",
  "iframeAllow": "camera; microphone; fullscreen; autoplay; encrypted-media",
  "rejectionCode": null,
  "rejectionMessage": null,
  "createdAt": "2026-06-19T14:40:00.000Z",
  "updatedAt": "2026-06-19T14:40:00.000Z",
  "completedAt": null
}

​
200 OK — sin sesiones

null

​
Flujo recomendado

  1. POST /api/kyc/biometric/sessions → guardar id y sessionUrl
  2. Embeber sessionUrl en iframe
  3. Polling: GET /api/kyc/biometric/entities/{entityId}/current o GET /api/kyc/biometric/sessions/{id}
  4. Si necesitás reiniciar: POST /api/kyc/biometric/sessions/{id}/cancel (solo pending / in_progress)

​
Diferencia con currentSessionId en el listado

GET /api/kyc/biometric/sessions?entityId=... incluye currentSessionId: es la última sesión approved (verificación biométrica vigente). Este endpoint /current devuelve la última sesión creada, que puede estar pending.
Campo / endpointQué representa
GET .../entities/:entityId/currentÚltima sesión creada (cualquier estado)
currentSessionId en listadoÚltima sesión aprobada

​
Error al crear segunda sesión

Si intentás crear otra sesión con una activa (pending / in_progress), recibís 409 ACTIVE_SESSION_EXISTS con el ID bloqueante: 
{
  "error": "ACTIVE_SESSION_EXISTS",
  "message": "The latest biometric session for this entity is still active...",
  "activeSessionId": "7618e10c-b1b1-408b-b361-1901077ced73"
}
Cancelá con POST /api/kyc/biometric/sessions/{activeSessionId}/cancel y volvé a crear.

​
Endpoints relacionados