Skip to main content
POST
Verify an email address
Verify one email address using your workspace API key. Send exactly one email field in a JSON body of at most 16 KiB. Surrounding whitespace is trimmed, and the trimmed address must be at most 320 characters. The legacy /email-verifier route remains available.

Usage and credits

The cost is 0.5 credits per request, reserved before verification. There is no endpoint-specific throttle. Allow at least 135 seconds, plus a network margin, in your client timeout. If verification remains inconclusive, the result is risky; waiting for that result does not add another charge.

Reading the response

Read the result from body when that object is present; otherwise read it from the top level. JSON object results include credits_consumed: 0.5 alongside the result. Wrapped results also include returned_an_error: false at the top level. Fields such as email, status, and result may be absent or have different types. Check the response content type before parsing: successful responses can also contain non-object JSON or non-JSON content without a credits_consumed field.

Errors and retries

An unsuccessful verification can return an error such as 422; error bodies can vary. Failed verification requests are eligible for a refund. A 503 can mean the charge or refund could not be confirmed, so do not assume the credits have been returned. This endpoint does not support caller idempotency keys. Retrying creates another verification request and can incur another charge. Use bounded backoff for temporary failures and avoid treating a timeout as proof that no credits were charged.

Next step

Use Email finder to find a work email, or check your credit balance.

Authorizations

Authorization
string
header
required

Use an Airscale workspace API key. Never expose the key in client-side code.

Body

application/json
email
string
required

One email address. Surrounding whitespace is trimmed; the trimmed value must be at most 320 characters. Maximum JSON body size: 16 KiB.

Pattern: ^\s*[^\s@]+@[^\s@]+\.[^\s@]+\s*$

Response

A verification result, either at the top level or inside body. JSON object results include credits_consumed; other fields are optional and their types can vary. Successful responses can also contain non-object JSON or non-JSON content without a credits_consumed field.

credits_consumed
number
required
email
any

Email address, when present. Validate the value type before using it.

status
any

Verification status, when present.

result
any

Deliverability result, when present; risky means verification remained inconclusive.

score
any

Deliverability score from 0 to 100, when present.

is_accept_all
any

Whether the domain accepts all addresses (catch-all), when present.

is_disposable
any

Whether the address is disposable, when present.

is_free
any

Whether the address uses a free email provider, when present.

is_role
any

Whether the address is a role address such as sales@, when present.

mx_records
any

Mail servers for the domain, when present.

smtp_provider
any

Mail hosting service for the domain, when present.

mode
any

Verification mode, when present.

id
any

Verification identifier, when present.

verify_at
any

Verification time, when present.

credits_remaining
any

Balance reported by the verification service, when present. This is not your Airscale credit balance; use POST /v1/credits for that.