--- title: Obtener Proceso description: Recupera un proceso de Human Token y su humanToken por el ID del proceso — después del Human Token Journey o para volver a consultar un resultado de API Only. canonical: https://developer.unico.io/es/human-token/api-reference/get-process locale: es generated_by: markdown-export --- - [/es/](/es/) - Referencia de API - Obtener Proceso **En esta páginaObtener ProcesoGETRecupera un proceso de Human Token por su identificador — después de que el usuario regresa del Human Token Journey o para volver a consultar un resultado de API Only. ### Endpoint​ EntornoURL**Producción**`GET https://humantoken.unico.app/client/v1/process/{processId}` ### Solicitud​ Headers HeaderValor`x-unico-accesskey``` (ver [Autenticación](/es/human-token/get-started/authentication)) Parámetros de ruta ParámetroTipoObligatorioDescripción`processId`string (UUID)síIdentificador del proceso devuelto por [Crear Proceso](/es/human-token/api-reference/post-processes). ### Ejemplo​ cURLNode.js``` curl -X GET https://humantoken.unico.app/client/v1/process/$PROCESS_ID \ -H "x-unico-accesskey: $UNICO_ACCESS_KEY" ``` ``` import fetch from 'node-fetch';const res = await fetch( `https://humantoken.unico.app/client/v1/process/${processId}`, { headers: { 'x-unico-accesskey': process.env.UNICO_ACCESS_KEY } });const result = await res.json();// result.data.humanToken.value ``` ### Respuestas​ 200 OK La respuesta tiene el mismo formato que [Crear Proceso](/es/human-token/api-reference/post-processes#responses). La forma de `data` depende del flujo utilizado cuando se creó el proceso. **Flujos estándar** (`api+humantoken`, `api+liveness+humantoken`, `humantoken`): ``` { "id": "6ed74799-4c2f-4023-b43f-a73cf7c847b2", "state": "PROCESS_STATE_FINISHED", "data": { "humanToken": { "value": "3f9a1c7e5b2d4086a1e3c5f7092b4d6e8a0c2e4f6183a5c7e9b1d3f5072a4c6e", "status": "validated" } }} ``` **Flujos de revalidación** (`api+liveness+humantoken+revalidation`, `humantoken+revalidation`): ``` { "id": "cb0472c0-6dbc-46c6-b830-2be7edc35424", "state": "PROCESS_STATE_FINISHED", "data": { "humanTokenMatch": "true" }} ``` CampoTipoDescripción`id`string (UUID)Identificador del proceso.`state`stringEstado del proceso — ver [valores de `state`](#state-values).`data.​humanToken.​value`stringSolo flujos estándar. Identificador estable y opaco del rostro (hasta 100 caracteres). La misma persona siempre resuelve al mismo valor.`data.​humanTokenMatch`stringSolo flujos de revalidación. `"true"` si el selfie coincide con el `humanToken` referenciado, `"false"` en caso contrario. Valores de state ValorSignificado`PROCESS_STATE_UNSPECIFIED`Estado no definido.`PROCESS_STATE_CREATED`El proceso fue creado y todavía acepta nuevas sesiones. `data` es `{}`.`PROCESS_STATE_FINISHED`El proceso finalizó y ya no acepta nuevas sesiones. Para flujos estándar, `data.humanToken` está presente cuando se generó un Human Token; para flujos de revalidación, `data.humanTokenMatch` indica si el selfie coincidió con el token referenciado. De lo contrario, `data` es `{}`.`PROCESS_STATE_FAILED`El proceso falló. `data` es `{}`.`PROCESS_STATE_CANCELED`El proceso fue cancelado. `data` es `{}`.`PROCESS_STATE_AWAITING_FOR_DOCUMENT`El proceso espera un documento de identificación. `data` es `{}`. advertenciaVerifica siempre que `data.humanToken.value` no esté vacío antes de usarlo. ### Códigos de Error​ 400 Bad Request401 Unauthorized404 Not Found429 Too Many Requests500 Internal Server ErrorCódigoMensajeDescripción`3`process id is invalidCuando el ID del proceso es inválido.Clave de acceso ausente o inválida en el header `x-unico-accesskey`. Ver [Autenticación](/es/human-token/get-started/authentication).CódigoMensajeDescripción`5`error getting process: rpc error: code = NotFound desc = process not foundCuando no se encontró el ID del proceso.Se alcanzó el límite de tasa. Cuando su sistema recibe un error HTTP 429, debe implementar mecanismos para prevenir fallos en cascada y evitar empeorar la restricción. **Mejores prácticas:** **Período de enfriamiento (backoff):** Detenga o reduzca inmediatamente las solicitudes posteriores de su sistema. No reintente continuamente las solicitudes fallidas en un bucle cerrado. **Cola y limitación (Queueing & throttling):** Almacene en búfer o ponga en cola las solicitudes salientes de su lado para controlar el flujo de tráfico antes de reenviarlas. **Backoff exponencial con jitter:** Al reintentar, aumente el tiempo de espera exponencialmente entre intentos (por ejemplo, 1 s, 2 s, 4 s, 8 s) y agregue un pequeño retraso aleatorio ("jitter") para evitar un efecto de manada donde todas las solicitudes en cola reintentan en el mismo milisegundo exacto. advertenciaEnviar solicitudes continuamente a un endpoint con límite de tasa sin aplicar backoff puede **prolongar el período de restricción** e impactar gravemente el rendimiento operativo de su sistema. Limitar adecuadamente las solicitudes de su lado garantiza una integración más fluida y resiliente. Para conocer los límites predeterminados, aumentar solicitudes y obtener detalles adicionales, consulte [Límites de tasa](/es/developers/start/rate-limits).CódigoMensajeDescripción`99999`Internal failure! Try again laterCuando ocurre un error interno. ### Qué sigue​ Vuelve a [Crear Proceso](/es/human-token/api-reference/post-processes) para enviar un nuevo selfie. Para entender qué representa el `humanToken` y cuándo no se genera, consulta la [descripción general de Human Token](/es/human-token/). Última actualización el 22 oct 2026**