Saltar al contenido principal
POST
curl
Prepara un único ZIP con todos los archivos de una sesión de Verificación de usuarios (KYC) o de Verificación de empresas (KYB): caras del documento, selfies, videos de prueba de vida y documentos subidos, en su calidad original. El ZIP se prepara en segundo plano. La llamada responde 202 con la exportación; consúltala con Obtener exportación de archivos hasta que status sea READY y, después, descarga download_url.
  • Mientras se esté preparando una exportación de la misma sesión, la llamada devuelve esa exportación en lugar de iniciar una nueva.
  • El ZIP se elimina 24 horas después de estar listo, y de inmediato cuando se elimina la sesión.
  • Una sesión eliminada no se puede exportar: la llamada devuelve 404.
  • Cada exportación queda registrada en el registro de auditoría de la sesión.
  • Una clave de API con permisos limitados necesita media: read y decisions: read.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

sessionId
string<uuid>
requerido

UUID de la sesión de verificación (el session_id que devuelve POST /v3/session/). Acepta ID de sesión tanto de Verificación de usuarios (KYC) como de Verificación de empresas (KYB). Una sesión eliminada devuelve 404.

Ejemplo:

"11111111-2222-3333-4444-555555555555"

Respuesta

La exportación, en preparación.

Un ZIP con todos los archivos de una sesión, en calidad original.

export_id
string<uuid>
requerido

ID de la exportación. Pásalo a GET /v3/session/{sessionId}/files-export/{exportId}/.

session_id
string<uuid>
requerido

La sesión de la que proceden los archivos.

status
enum<string>
requerido

PENDING y PROCESSING mientras se prepara el ZIP, READY cuando ya se puede descargar, FAILED cuando no se pudo preparar (solicita una nueva exportación), EXPIRED cuando el ZIP se eliminó.

Opciones disponibles:
PENDING,
PROCESSING,
READY,
FAILED,
EXPIRED
file_count
integer | null
requerido

Archivos del ZIP. Solo se rellena mientras status es READY.

size_bytes
integer<int64> | null
requerido

Tamaño del ZIP en bytes. Solo se establece mientras status es READY.

download_url
string<uri> | null
requerido

URL firmada del ZIP, válida durante poco tiempo. Solo se establece mientras status es READY; vuelve a leer la exportación para obtener una nueva.

expires_at
string<date-time> | null
requerido

Cuándo se elimina el ZIP, 24 horas después de estar listo. Solo se define mientras status es READY.

error
string | null
requerido

Por qué falló la exportación, cuando status es FAILED.

created_at
string<date-time>
requerido

Cuándo se solicitó la exportación.

completed_at
string<date-time> | null
requerido

Cuándo estuvo listo el ZIP o cuándo falló la exportación.

Última modificación el 1 de noviembre de 2026