Skip to content

Download Combined Bulk CSV

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

Returns one signed CDN URL for completed or partial groups. The CSV contains every original record plus validation columns, a zero-based global index, and errors. Formula-like cells are neutralized. Signatures last at most one hour and never outlive the group’s 30-day retention.

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

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

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

Signed combined CSV download.

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.