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.

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
jobId
required
string format: uuid

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

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

400

Section titled “ 400 ”

Invalid request envelope, pagination, identifier, or header.

401

Section titled “ 401 ”

Valid API authentication is required; submission requires write permission.

403

Section titled “ 403 ”

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

404

Section titled “ 404 ”

The job does not exist or belongs to another user.

409

Section titled “ 409 ”

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

410

Section titled “ 410 ”

Job results have expired.

413

Section titled “ 413 ”

Request body exceeds 5 MiB.

429

Section titled “ 429 ”

Three unfinished submissions or unclaimed uploads already exist for this user.

503

Section titled “ 503 ”

Bulk admission is disabled or storage is temporarily unavailable.