Obtener URL de Descarga

GET/v1/tasks/{token}/result

Obtén el enlace de descarga del resultado. Los archivos se conservan 7 días por defecto (configurable mediante result_retention_days).

Ejemplo de Respuesta

{
  "task_id": "xKj9aP3qLm7v",
  "download_url": "https://api.zelnum.com/api/v1/tasks/xKj9aP3qLm7v/download",
  "expires_at": "2026-05-02T10:00:00+00:00",
  "summary": {
    "submitted": 5000,
    "prefiltered": 0,
    "deduped": 0,
    "total": 5000,
    "valid": 3800,
    "invalid": 1200,
    "unknown": 0,
    "unknown_processed": 0,
    "unknown_unprocessed": 0
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
task_id	string	Token con el que consultas y descargas. Este es el parámetro de ruta {token} de los endpoints de tarea.
download_url	string (URL)	URL del archivo de resultados. Requiere la misma clave de API que todas las demás llamadas.
expires_at	string (ISO 8601) | null	Cuándo el archivo deja de poder descargarse.
summary.submitted	integer	Filas recibidas en el envío.
summary.prefiltered	integer	Filas descartadas antes de la detección, por ejemplo líneas mal formadas.
summary.deduped	integer	Filas duplicadas eliminadas.
summary.total	integer	Filas realmente en cola para detección, después del prefiltrado y la deduplicación.
summary.valid	integer	Filas confirmadas como registradas.
summary.invalid	integer	Filas confirmadas como no registradas.
summary.unknown	integer	Filas que el proveedor no pudo resolver.
summary.unknown_processed	integer	Filas desconocidas que se reintentaron y se liquidaron.
summary.unknown_unprocessed	integer	Filas desconocidas aún sin resolver. Se reembolsan.

Precaución

Descarga el archivo antes de expires_at. Los resultados caducados se eliminan de forma permanente y no se pueden recuperar.

Descargar el archivo de resultados

GET/v1/tasks/{token}/download

curl -X GET "https://api.zelnum.com/api/v1/tasks/xKj9aP3qLm7v/download" \
  -H "X-API-Key: YOUR_KEY_HERE" \
  -o result.zip

Descarga el archivo de resultados ya finalizado como adjunto. Puedes seguir el download_url del endpoint de resultados o llamar a este endpoint con el mismo token de tarea.

Cuando expira el periodo de retención el archivo se elimina y este endpoint devuelve 404: hay que volver a enviar la tarea para regenerarlo.

• 404 — El task_id no existe o pertenece a otra cuenta.
• 404 — El archivo de resultados está vencido, no existe o no está disponible.
• 422 — La tarea no está completa, o su archivo de resultados aún no se ha generado.

Siguiente

• Ejemplos masivos: todo el ciclo enviar → consultar → descargar en un solo script