Skip to content

Download Bulk Validation CSV

GET
/emails/bulk/{jobId}/download
curl --request GET \
--url https://api.unwrap.email/v1/emails/bulk/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/download \
--header 'UNWRAP-EMAIL-API-TOKEN: <UNWRAP-EMAIL-API-TOKEN>'

Returns a signed CDN link valid for at most one hour, capped by job expiry. CSV preserves input order and includes flattened result fields, JSON arrays, and safely escaped errors.

jobId
required
string format: uuid

Signed CSV link for a completed job.

Media type application/json
object
download_url
required
string format: uri
expires_at
required
string format: date-time
Example generated
{
"download_url": "https://example.com",
"expires_at": "2026-04-15T12:00:00Z"
}

Invalid request envelope, pagination, identifier, or header.

Valid API authentication is required; submission requires write permission.

API-token access requires an active subscription. Submission also requires an active subscription for session and bearer callers.

The job does not exist or belongs to another user.

Idempotency-Key input mismatch, or CSV is not ready.

Job results have expired.

Request body exceeds 5 MiB.

Three unfinished jobs already exist for this user.

Bulk admission is disabled or storage is temporarily unavailable.