Skip to main content
GET
Obtener medios de la validación KYC

Resumen

Cuando una validación KYC por sesión termina (p. ej. approved), las referencias a medios aparecen dentro de decision en GET /api/kyc/validations/:id (imágenes del documento, retrato, video de liveness, etc.). Formato habitual: cada referencia es una clave kyc/... (cadena de ruta). Para descargar los bytes usá el endpoint de medios de abajo con tu API key. Forma de decision: los resultados aparecen como objeto singular y array de un elemento (p. ej. id_verification e id_verifications[0]). Gu1 los mantiene sincronizados. Ver Eventos webhook KYC para un ejemplo completo. Si la copia todavía no está: el campo queda null. La respuesta no incluye un enlace externo. Un sync o un webhook posterior vuelve a intentar guardar el archivo. Cuando sale bien, el campo pasa a ser una clave kyc/.... Esta guía es para el KYC completo por sesión (global_gueno_validation_kyc). Face Match e ID Verification usan otros endpoints (barra lateral).

Medios que todavía no están en Gu1

  • Nada se borra del resto del decision: solo el campo de ese archivo queda vacío hasta que la copia termina.
  • Claves kyc/...: usá GET /api/kyc/validations/:id/media con key codificada en la URL. El acceso queda acotado a tu organización y a esa validación.
  • Campo null: Gu1 todavía no tiene el archivo. No uses un enlace externo. La siguiente sincronización vuelve a intentar la copia.
  • Cuando la copia termina, el mismo campo pasa a ser una clave kyc/....

Solicitud

Endpoint

Headers

  • Authorization: Bearer TU_API_KEY (obligatorio)

Query parameters

Permisos

La API key debe poder leer KYC (kyc:read si la clave usa permisos granulares; si no, se aplica el rol del usuario dueño de la clave, con compatibilidad heredada donde corresponda—igual que GET /api/kyc/validations/:id).

Respuesta

Cuerpo del archivo en bruto. El Content-Type corresponde al tipo de recurso (p. ej. image/jpeg, video/webm).

Ejemplo

En tu aplicación, construí la query con encodeURIComponent(key) para codificar cada / de la clave.
El parámetro key no es un secreto y no sustituye la autenticación. Siempre enviá Authorization: Bearer válido; la API comprueba que la clave de objeto pertenezca a esa validación y a tu organización.

Relacionado