Skip to content

Get Bulk Validation Group

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

Returns the group phase, aggregate counts, export readiness, and children with failure messages, original row offsets, and individual status URLs. A partial group includes job_failed rows; ordinary row validation errors still permit completed status. Original records are preserved in order, including duplicates. Appended export columns use result_prefix, normally unwrap., or the first unused numbered namespace.

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 ”

Group progress and child-job summaries.

Media type application/json
object
group
required
object
id
required
string format: uuid
status
required
string
Allowed values: queued parsing processing finalizing completed partial failed expired
total
required
integer
processed
required
integer
success
required
integer
errors
required
integer
unprocessed
required
integer
failure
required
string | null
result_prefix
required
string | null
download_ready
required
boolean
created_at
required
string format: date-time
updated_at
required
string format: date-time
expires_at
required
string format: date-time
jobs
required
Array<object>
object
id
required
string
status
required
string
Allowed values: pending processing completed failed expired
total
required
integer
processed
required
integer
success
required
integer
errors
required
integer
created_at
required
string format: date-time
updated_at
required
string format: date-time
expires_at
required
string format: date-time
failure
required
string | null
ordinal
required
integer
row_offset
required
integer
status_url
required
string format: uri
Example 
{
  "group": {
    "status": "queued"
  },
  "jobs": [
    {
      "status": "pending"
    }
  ]
}

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.