Skip to content

Submit Bulk Validation

POST
/emails/bulk
 
curl --request POST \
  --url https://api.unwrap.email/v1/emails/bulk \
  --header 'Content-Type: application/json' \
  --header 'UNWRAP-EMAIL-API-TOKEN: <UNWRAP-EMAIL-API-TOKEN>' \
  --data '{ "emails": [ "example" ], "validate_domain": 0 }'

Validate up to 10,000 email strings asynchronously. Duplicates are processed and billed individually. Malformed rows are unbilled errors. Jobs expire 30 days after submission. validate_domain defaults to 0. Requires a write token and active subscription. Use Idempotency-Key for safe submission retries.

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “ Header Parameters ”
idempotency-key
string
>= 1 characters <= 255 characters

Request Body required

Section titled “ Request Body required ”
Media type application/json
object
emails
required

Email strings in input order; malformed addresses, including addresses over 254 characters or local parts over 64 characters, receive individual errors.

Array<string>
>= 1 items <= 10000 items
validate_domain
Any of:
number
Allowed values: 0

Responses

Section titled “ Responses ”

202

Section titled “ 202 ”

Accepted job, or the job from an identical idempotent submission.

Media type application/json
object
job
required
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
status_url
required
string format: uri
Example 
{
  "job": {
    "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 jobs already exist for this user.

503

Section titled “ 503 ”

Bulk admission is disabled or storage is temporarily unavailable.