Skip to main content
GET
http://api.gu1.ai
/
api
/
kyc
/
id-verification
/
verifications
Obtener ID Verification (Listado, Uno, Imágenes)
curl --request GET \
  --url http://api.gu1.ai/api/kyc/id-verification/verifications \
  --header 'Authorization: Bearer <token>'

​
Resumen

Cada envío por POST ID Verification se guarda para auditoría. Podés:
  1. Listar verificaciones (con filtros opcionales: entityId, withoutEntity, status, paginación).
  2. Obtener una verificación por ID (el mismo UUID que verificationId en la respuesta del POST).
  3. Obtener las imágenes almacenadas (frente/reverso del documento) cuando la verificación tenga rutas de almacenamiento.
Todos los endpoints están limitados a tu organización. En las respuestas no se menciona ningún proveedor externo.

​
1. Listar verificaciones

GET https://api.gu1.ai/api/kyc/id-verification/verifications

​
Parámetros de query

ParámetroTipoDescripción
entityIdstring (UUID)Opcional. Filtrar por entidad persona.
withoutEntitybooleanSi es true, solo verificaciones sin entidad asociada.
statusstringOpcional. approved | declined | failed.
limitnumberMáximo de ítems (por defecto 50, máx. 100).
offsetnumberDesplazamiento para paginación.

​
Respuesta (200 OK)

{
  "verifications": [
    {
      "id": "uuid",
      "organizationId": "uuid",
      "entityId": "uuid | null",
      "status": "approved",
      "requestId": "string | null",
      "vendorData": "string | null",
      "errorMessage": "string | null",
      "warnings": ["string"],
      "extractedData": { },
      "createdAt": "ISO8601",
      "documentFrontStoragePath": "string | null",
      "documentBackStoragePath": "string | null",
      "storageProvider": "s3 | local | null"
    }
  ],
  "pagination": { "limit", "offset", "total" }
}

​
2. Obtener una verificación

GET https://api.gu1.ai/api/kyc/id-verification/verifications/:id
Devuelve un registro de auditoría por ID. Usá el verificationId de la respuesta del POST o del listado.

​
Parámetros de path

​
id
string
required
UUID de la verificación ID (el mismo que verificationId del POST o del listado).

​
Respuesta (200 OK)

Mismo formato que un ítem del listado. 404 si no existe o no pertenece a tu organización.

​
3. Obtener imágenes del documento almacenadas

Cuando la verificación tiene documentFrontStoragePath o documentBackStoragePath, podés obtener los bytes de la imagen: 
GET https://api.gu1.ai/api/kyc/id-verification/verifications/:id/document-front-image
GET https://api.gu1.ai/api/kyc/id-verification/verifications/:id/document-back-image

​
Parámetros de path

​
id
string
required
UUID de la verificación.

​
Respuesta

  • 200: Cuerpo de la imagen (ej. Content-Type: image/jpeg).
  • 404: Verificación no encontrada o esa imagen no fue almacenada.

​
Headers

En todas las solicitudes: 
Authorization: Bearer TU_API_KEY
Incluí X-Organization-Id si tu cuenta está limitada por organización.

​
Errores

CódigoHTTPDescripción
NOT_FOUND404El ID de verificación no existe o pertenece a otra organización.
UNAUTHORIZED401API key u organización faltante o inválida.

​
Ejemplo

const response = await fetch(
  'https://api.gu1.ai/api/kyc/id-verification/verifications?limit=20',
  { headers: { 'Authorization': 'Bearer TU_API_KEY' } }
);
const { verifications, pagination } = await response.json();

​
Próximos pasos

ID Verification (POST)

Enviar frente/reverso y obtener validación

Face Match

Comparar documento y selfie