Ссылка на результат

GET/v1/tasks/{token}/result

Получите ссылку для скачивания результата. Файлы хранятся 7 дней по умолчанию (настраивается через result_retention_days).

Пример ответа

{
  "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
  }
}

Поля ответа

Поле	Тип	Описание
`task_id`	string	Токен, с которым вы опрашиваете статус и скачиваете результат. Это параметр пути `{token}` эндпоинтов задачи.
`download_url`	string (URL)	URL файла результата. Требует тот же ключ API, что и любой другой вызов.
`expires_at`	string (ISO 8601) \| null	Когда файл перестаёт скачиваться.
`summary.submitted`	integer	Строк получено в отправке.
`summary.prefiltered`	integer	Строки, отброшенные до проверки, — например, некорректные.
`summary.deduped`	integer	Удалено дублирующихся строк.
`summary.total`	integer	Строк фактически поставлено на проверку после префильтрации и дедупликации.
`summary.valid`	integer	Строки, подтверждённые как зарегистрированные.
`summary.invalid`	integer	Строки, подтверждённые как незарегистрированные.
`summary.unknown`	integer	Строки, которые провайдер не смог обработать.
`summary.unknown_processed`	integer	Неизвестные строки, повторно проверенные и завершённые.
`summary.unknown_unprocessed`	integer	Неизвестные строки, всё ещё не обработанные. За них возвращаются средства.

Скачать файл с результатами

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

Напрямую отдаёт готовый файл с результатами как вложение. Можно перейти по download_url из эндпоинта результата либо вызвать этот эндпоинт с тем же токеном задачи.

После истечения срока хранения файл удаляется, и этот эндпоинт возвращает 404 — задачу нужно отправить заново, чтобы сформировать его повторно.

404 — task_id не существует или принадлежит другому аккаунту.
404 — Файл результата истёк, отсутствует или недоступен.
422 — Задача не завершена или файл результата ещё не сформирован.

Дальше

Пакетные примеры — весь цикл отправка → опрос → скачивание в одном скрипте