Obtener proceso

advertencia

Antes de recuperar el proceso, revisa la configuración de nuestro webhook y las estrategias de fallback — haz clic aquí.

En el contrato de API, la respuesta de POST /processes/v1 ya es el resultado final. Este endpoint existe para reconsultas — por ejemplo, cuando necesitas inspeccionar un proceso que persististe anteriormente o auditar una transacción anterior.

Endpoint

Entorno	URL
Producción	GET https://api.id.unico.app/processes/v1/{processId}
Sandbox	GET https://api.id.uat.unico.app/processes/v1/{processId}

Solicitud

Headers

Header	Valor
Authorization	Bearer <access_token>
APIKEY	Clave de API aprovisionada.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
processId	string (UUID)	sí	Identificador del proceso devuelto por Crear proceso.

Ejemplo

cURL

curl -X GET https://api.id.unico.app/processes/v1/$PROCESS_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "APIKEY: $API_KEY"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.id.unico.app/processes/v1/${processId}`,
  {
    headers: {
      Authorization: `Bearer ${accessToken}`,
      APIKEY: apiKey
    }
  }
);
const result = await res.json();

Respuestas

200 OK

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": { "result": "yes" },
  "identityFraudsters": { "result": "inconclusive" },
  "government": { "serpro": 87 },
  "liveness": 1
}

Campo	Tipo	Descripción
id	string (UUID)	Identificador del proceso.
status	integer	1 (procesando), 2 (divergencia), 3 (finalizado con éxito), 4 (cancelado), 5 (error).
unicoId.result	string	yes, no, inconclusive — ver Verificación de identidad.
identityFraudsters.result	string	yes, inconclusive — ver Clasificación de riesgo.
government.serpro	integer	Puntuación de similitud de Serpro (0–100, -1, -2). Ver Similitud Serpro.
liveness	integer	1 (aprobado), 2 (reprobado) — ver Liveness.
score	integer	Puntuación de riesgo probabilístico. Presente cuando unicoId.result = inconclusive y la orquestación de puntuación de riesgo está activa. Los valores positivos indican mayor probabilidad de ser el titular; los valores negativos indican mayor riesgo.

400 Bad Request

El parámetro de ruta processId está ausente o tiene un formato incorrecto. Ver Códigos de error a continuación.

403 Forbidden

El token Bearer o APIKEY está ausente, expirado o es inválido.

404 Not Found

El processId no existe o no pertenece al tenant autenticado.

410 Gone

El proceso existe pero resultó en un error. Devuelve solo id y status: 5.

429 Too Many Requests

Límite de tasa alcanzado. Ver Límites de tasa.

500 Internal Server Error

Error interno inesperado del servidor.

Cuándo usar este endpoint

El contrato de API devuelve resultados de forma sincrónica, por lo que la mayoría de las integraciones no necesitan este endpoint. Úsalo cuando:

• Persististe solo el processId y necesitas recuperar el resultado completo más tarde (auditoría, soporte).
• Sospechas que la respuesta original se perdió en tránsito (error de red después de que la plataforma completó el trabajo).
• Estás construyendo una herramienta de back-office que revisa procesos históricos.

Códigos de Error

400 Bad Request

Código	Mensaje	Descripción
20023	O parâmetro processId não foi informado.	El parámetro process id está ausente.
20002	O parâmetro APIKey não foi informado.	El parámetro APIKEY está ausente del encabezado de la solicitud.
20001	O parâmetro authtoken não foi informado.	El parámetro de token de integración está ausente del encabezado de la solicitud.

404 Not Found

Código	Mensaje	Descripción
50001	O processo informado não foi encontrado.	El proceso no existe en la base de datos.

403 Forbidden

Código	Mensaje	Descripción
30017	User does not have permission to perform this action.	JWT malformado o usuario sin permiso para realizar esta operación.
10502	O token informado está expirado.	El access-token utilizado ha expirado.
10501	O token informado é inválido.	El token de autenticación es inválido.
10201	O AppKey informado é inválido.	El parámetro APIKEY no ha sido ingresado o no existe.

410 Gone

El proceso existe pero resultó en un error. Devuelve solo id y status: 5.

500 Internal Server Error

Código	Mensaje	Descripción
99999	Internal failure! Try again later	Cuando ocurre un error interno.