Migrate from ZeroBounce to Emailable

How to switch

Start with these three changes. You'll find the details and request examples below.

1 Get an API key

Create your Emailable account and generate an API key from the dashboard. Use a test key while you connect everything; test requests don't use credits.
2 Update the endpoint

Send the email address and your API key in one GET request. You won't need an IP address parameter or separate endpoints for different checks.
3 Map the response fields

ZeroBounce's status becomes state and sub_status becomes reason. Most of the other fields match one to one.

Update your API integration

Compare the request and response formats, then update the fields your application uses.

ZeroBounce request

ZeroBounce response

{
  "address": "john.doe@zerobounce.net",
  "status": "valid",
  "sub_status": "",
  "free_email": false,
  "catchall_domain": true,
  "did_you_mean": null,
  "account": "johndoe",
  "domain": "zerobounce.net",
  "domain_age_days": "3431",
  "active_in_days": "30",
  "active_first_seen": "2026-02-25",
  "smtp_provider": "g-suite",
  "mx_found": "true",
  "mx_record": "aspmx.l.google.com",
  "firstname": "dan",
  "lastname": "cotet",
  "gender": "male",
  "country": null,
  "region": null,
  "city": null,
  "zipcode": null,
  "processed_at": "2026-06-18 07:05:00.033"
}

Emailable request

Emailable response

{
  "accept_all": false,
  "did_you_mean": null,
  "disposable": false,
  "domain": "example.com",
  "duration": 0.493,
  "email": "support@example.com",
  "first_name": null,
  "free": false,
  "full_name": null,
  "gender": null,
  "last_name": null,
  "mailbox_full": false,
  "mx_record": "mx.example.com",
  "no_reply": false,
  "reason": "accepted_email",
  "role": true,
  "score": 100,
  "smtp_provider": null,
  "state": "deliverable",
  "tag": null,
  "user": "support"
}

View the full response

ZeroBounce request

curl -X POST "https://api.zerobounce.net/v2/validatebatch" \
-H "Content-Type: application/json" \
-d '{
  "api_key": "your_api_key",
  "email_batch": [
    { "email_address": "john.doe@zerobounce.net", "ip_address": "1.1.1.1" },
    { "email_address": "invalid@example.com", "ip_address": "1.1.1.1" },
    { "email_address": "disposable@example.com", "ip_address": null }
  ],
  "activity_data": true,
  "verify_plus": true
}'

ZeroBounce response

{
  "email_batch": [
    {
      "address": "john.doe@zerobounce.net",
      "status": "valid",
      "sub_status": "",
      "free_email": false,
      "catchall_domain": true,
      "did_you_mean": null,
      "account": "johndoe",
      "domain": "zerobounce.net",
      "domain_age_days": "3431",
      "active_in_days": "30",
      "active_first_seen": "2026-02-25",
      "smtp_provider": "g-suite",
      "mx_found": "true",
      "mx_record": "aspmx.l.google.com",
      "firstname": "dan",
      "lastname": "cotet",
      "gender": "male",
      "country": null,
      "region": null,
      "city": null,
      "zipcode": null,
      "processed_at": "2026-06-18 07:05:00.033"
    },
    {
      "address": "invalid@example.com",
      "status": "invalid",
      "sub_status": "mailbox_not_found",
      "free_email": false,
      "did_you_mean": null,
      "account": null,
      "domain": null,
      "domain_age_days": "9692",
      "active_in_days": "365",
      "active_first_seen": "2026-02-25",
      "smtp_provider": "example",
      "mx_found": "true",
      "mx_record": "mx.example.com",
      "catchall_domain": false,
      "firstname": "zero",
      "lastname": "bounce",
      "gender": "male",
      "country": null,
      "region": null,
      "city": null,
      "zipcode": null,
      "processed_at": "2020-09-17 17:43:11.830"
    },
    {
      "address": "disposable@example.com",
      "status": "do_not_mail",
      "sub_status": "disposable",
      "free_email": false,
      "did_you_mean": null,
      "account": null,
      "domain": null,
      "domain_age_days": "9692",
      "active_in_days": "365",
      "active_first_seen": "2026-02-25",
      "smtp_provider": "example",
      "mx_found": "true",
      "mx_record": "mx.example.com",
      "catchall_domain": false,
      "firstname": "zero",
      "lastname": "bounce",
      "gender": "male",
      "country": null,
      "region": null,
      "city": null,
      "zipcode": null,
      "processed_at": "2020-09-17 17:43:11.830"
    }
  ],
  "errors": []
}

Emailable request

curl -X POST "https://api.emailable.com/v1/batch" \
-H "Content-Type: application/json" \
-d '{
  "api_key": "your_api_key",
  "emails": [
    "tim@smith.com",
    "john@smith.com",
    "support@emailable.com"
  ],
  "url": "https://example.com/callback"
}'

Emailable response

{
  "emails": [
    {
      "accept_all": false,
      "did_you_mean": null,
      "disposable": false,
      "domain": "smith.com",
      "email": "tim@smith.com",
      "first_name": "Tim",
      "free": false,
      "full_name": "Tim",
      "gender": "male",
      "last_name": null,
      "mailbox_full": false,
      "mx_record": "mx.smith.com",
      "no_reply": false,
      "reason": "accepted_email",
      "role": false,
      "score": 100,
      "smtp_provider": null,
      "state": "deliverable",
      "tag": null,
      "user": "tim"
    },
    {
      "accept_all": false,
      "did_you_mean": null,
      "disposable": false,
      "domain": "smith.com",
      "email": "john@smith.com",
      "first_name": "John",
      "free": false,
      "full_name": "John",
      "gender": "male",
      "last_name": null,
      "mailbox_full": false,
      "mx_record": "mx.smith.com",
      "no_reply": false,
      "reason": "rejected_email",
      "role": false,
      "score": 0,
      "smtp_provider": null,
      "state": "undeliverable",
      "tag": null,
      "user": "john"
    },
    {
      "accept_all": false,
      "did_you_mean": null,
      "disposable": false,
      "domain": "emailable.com",
      "email": "support@emailable.com",
      "first_name": null,
      "free": false,
      "full_name": null,
      "gender": null,
      "last_name": null,
      "mailbox_full": false,
      "mx_record": "aspmx.l.google.com",
      "no_reply": false,
      "reason": "low_quality",
      "role": true,
      "score": 70,
      "smtp_provider": "Google",
      "state": "risky",
      "tag": null,
      "user": "support"
    }
  ],
  "id": "5cf6dd30093f96d2ac34bb0a",
  "message": "Batch verification completed.",
  "reason_counts": {
    "accepted_email": 1,
    "invalid_domain": 0,
    "invalid_email": 0,
    "invalid_smtp": 0,
    "low_deliverability": 0,
    "low_quality": 1,
    "no_connect": 0,
    "rejected_email": 1,
    "timeout": 0,
    "unavailable_smtp": 0,
    "unexpected_error": 0
  },
  "total_counts": {
    "deliverable": 1,
    "processed": 3,
    "risky": 1,
    "total": 3,
    "undeliverable": 1,
    "unknown": 0,
    "duplicate": 0
  }
}

View the full response

How the batch endpoints differ

ZeroBounce's batch endpoint holds the request open until every address is checked, and their docs point you to the bulk file endpoints past 200 addresses. Emailable's batch API accepts up to 50,000 addresses in the request and can send the results to your callback URL.

Emailable enterprise accounts can request larger batches by contacting support.

Getting your results

For API batches, use the returned ID to check the status, or add a callback URL and we'll notify your application when it's done. Batches larger than 1,000 addresses return a CSV download link.

For batches up to 1,000 addresses, add partial=true to the status request to read results while the batch is still verifying.

One-off lists

For a one-off email list, skip the batch API and use the Bulk Verifier in your Emailable dashboard. Upload the file there, then export the results when it's done.

View the Bulk Verifier guide

Match up the responses

Most of what ZeroBounce returns has a matching Emailable field. Use these tables to see what changed and what stayed the same.

Map statuses to states

ZeroBounce status	Emailable state
`valid`	`deliverable`
`invalid`	`undeliverable`
`catch-all`	`risky`
`do_not_mail`	`risky`
`abuse`	—
`spamtrap`
`unknown`	`unknown`

A dash means there isn't a matching Emailable state. Use the score and risk flags to decide how your application should handle those addresses.

See all states and reasons

Map the response fields

ZeroBounce field	Emailable field
`address`	`email`
`status`	`state`
`sub_status`	`reason`
`account`	`user`
`domain`	`domain`
`did_you_mean`	`did_you_mean`
`free_email`	`free`
`catchall_domain`	`accept_all`
`smtp_provider`	`smtp_provider`
`mx_record`	`mx_record`
`firstname`	`first_name`
`lastname`	`last_name`
`gender`	`gender`

Emailable also returns these fields, which have no ZeroBounce equivalent:

score role disposable mailbox_full no_reply tag

See all response fields

Test before you switch

Connect your integration with a test key first. Emailable's test addresses return fixed results, so you can try every state and attribute before going live without using credits.

View all test addresses

Bulk

Verifier

API

Widget

Deliverability

Migrate from ZeroBounce to Emailable

How to switch

1 Get an API key

2 Update the endpoint

3 Map the response fields

Update your API integration

How the batch endpoints differ

Getting your results

One-off lists

Match up the responses

Map statuses to states

No equivalent state

Map the response fields

Test before you switch

Docs to keep handy

Emails

Authentication

Rate Limits

Status Codes

Account

All Possible States & Reasons

Migrate from ZeroBounce

Compare Emailable and ZeroBounce

Compare a few more options

Join the world's largest companies that rely on Emailable to protect their sender reputation