Saltar al contenido principal
GET
curl
Consulta una exportación iniciada con Exportar archivos.
  • PENDING y PROCESSING: el ZIP se está preparando. Vuelve a consultar la exportación en unos segundos.
  • READY: download_url es un enlace firmado al ZIP que es válido durante poco tiempo. Vuelve a consultar la exportación para obtener un enlace nuevo hasta expires_at.
  • FAILED: no se pudo preparar el ZIP. Inicia una nueva exportación.
  • EXPIRED: el ZIP se eliminó. Inicia una nueva exportación.
Cada consulta que proporciona un enlace de descarga queda registrada en el registro de auditoría de la sesión. La exportación de una sesión eliminada devuelve 404.

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"

exportId
string<uuid>
requerido

El export_id que devuelve POST /v3/session/{sessionId}/files-export/.

Ejemplo:

"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"

Respuesta

La exportació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