API Migration

NeverBounce

Validate/Verify a single email address:

NeverBounce
URL
GET
https://api.neverbounce.com/v4/single/check

GET
API DEFAULT URL:https://api.zerobounce.net/v2/validate
API U.S.A. URL*:https://api-us.zerobounce.net/v2/validate
API EU URL:https://api-eu.zerobounce.net/v2/validate
Request
• key
• email

• api_key
• email
• ip_address
Response
Response example:
{
"status": "success",
"result": "valid",
"flags": ["has_dns", "has_dns_mx"],
"suggested_correction": ""
"retry_token": "",
"execution_time": 499
}

Response example:
"address": "youremail@domain.com",
"status": "catch-all",
"sub_status": "",
"free_email": false,
"did_you_mean": null,
"account": "youremail",
"domain": "domain.com",
"domain_age_days": "11750",
"smtp_provider": "example",
"mx_found": "true",
"mx_record": "mxa-00*****.gslb.*****ted.com",
"firstname": null,
"lastname": null,
"gender": null,
"country": null,
"region": null,
"city": null,
"zipcode": null,
"processed_at": "2023-07-20 17:10:08.083"

Examples:

HTTP request

ZeroBounce:

API DEFAULT URL:https://api.zerobounce.net/v2/validate?api_key=ReplaceWithYourApiKey&email=ReplaceWithYours

API U.S.A. URL*:https://api-us.zerobounce.net/v2/validate?api_key=ReplaceWithYourApiKey&email=ReplaceWithYours

API EU URL: https://api-eu.zerobounce.net/v2/validate?api_key=ReplaceWithYourApiKey&email=ReplaceWithYours

HTTP request
NeverBounce: https://api.neverbounce.com/v4/single/check?key=ReplaceWithYours&email=ReplaceWithYours

*This endpoint uses servers located within the United States. By utilizing this endpoint, you acknowledge and consent to your data being processed on servers in the United States.

Verifying a list or ZeroBounce’s Batch validator

NeverBounce
URL
POST
https://api.neverbounce.com/v4/jobs/create

POST
https://api.zerobounce.net/v2/validatebatch
https://api-us.zerobounce.net/v2/validatebatch
https://api-eu.zerobounce.net/v2/validatebatch
Request
Body-type: form-data
• key
• input_location
• filename
• auto_start
• auto_parse
• input

Params
• api_key
• email
Response
Example of successful response:
{
"status": "success",
"job_id": YourJobId,
"execution_time": 503
}

Example of successful response:
{"email_batch": [{
"address": "valid@example.com",
"status": "valid",
"sub_status": "",
"free_email": false,
"did_you_mean": null,
"account": null,
"domain": null,
"domain_age_days": "9692",
"smtp_provider": "example",
"mx_found": "true",
"mx_record": "mx.example.com",
"firstname": "zero",
"lastname": "bounce",
"gender": "male",
"country": null,
"region": null,
"city": null,
"zipcode": null,
"processed_at": "2020-09-17 17:43:11.829"
}]}

ZeroBounce’s list/batch email validator provides the results in the response body directly without the need of creating a task/job.

Sending a CSV by URL / BulkApi Send file

NeverBounce
URL
POST
https://api.neverbounce.com/v4/jobs/create

POST
https://bulkapi.zerobounce.net/v2/sendfile
Request
Body-type: form-data
• key
• input_location
• filename
• auto_parse
• auto_start
• input

Body-type: form-data
• file
• api_key
• return_url
• email_address_column
• first_name_column
• last_name_column
• gender_column
• ip_address_column
• has_header_row
Response
Example of successful response:
{
"status": "success",
"job_id": YourJobId,
"execution_time": 503
}

Example of successful response:
{
"success": true,
"message": "File Accepted",
"file_name": "ExampleCSV2.csv",
"file_id": "55634bf2-872b-439c-8ac4-0c7xxxxxxxxx"
}

Checking the status of a bulk validation / File Status

NeverBounce
URL
GET
https://api.neverbounce.com/v4/jobs/status

GET
https://bulkapi.zerobounce.net/v2/filestatus
Request
Params
• key
• job_id

Params
• api_key
• file_id
Response
Example of successful response:
{
"status": "success",
"id": YourJobId,
"filename": "NBUser_1054_58f2b406006f1",
"created": "2017-04-15 20:00:06",
"started": "2017-04-15 20:00:21",
"finished": "2017-04-15 21:52:46",
"total_records": 24606,
"total_billable": 24606,
"total_processed": 24606,
"total_valid": 18227,
"total_invalid": 1305,
"total_catchall": 4342,
"total_disposable": 16,
"total_unknown": 716,
"total_duplicates": 0,
"total_bad_syntax": 0,
"bounce_estimate": 5.3035844915874,
"percent_complete": 100,
"job_status": "complete",
"execution_time": 2535
}

Example of successful response:
{
"success": true,
"file_id": "YourFileID",
"file_name": "YourFile.csv",
"upload_date": "2023-07-27T10:37:55Z",
"file_status": "Complete",
"complete_percentage": "100%",
"error_reason": null,
"return_url": null
}

Example:

HTTP request
ZeroBounce: https://bulkapi.zerobounce.net/v2/filestatus?api_key=ReplaceWithYourApiKey&file_id=ReplaceWithYours

HTTP request
NeverBounce: https://api.neverbounce.com/v4/jobs/status?key=ReplaceWithYours&job_id=ReplaceWithYours

Retrieving the Results / Get File

NeverBounce
URL
GET
https://api.neverbounce.com/v4/jobs/download

GET
https://bulkapi.zerobounce.net/v2/getfile
Request
Params
• key
• job_id

Params
• api_key
• file_id
Response
Example of successful response:
"support@neverbounce.com", "Fred McValid", valid "invalid@neverbounce.com", "Bob McInvalid", invalid'

Example of successful response:
"Email Address", "Custom", "Custom", "Custom", "ZB Status", "ZB Sub Status", "ZB Account", "ZB Domain", "ZB First Name", "ZB Last Name", "ZB Gender", "ZB Free Email", "ZB MX Found", "ZB MX Record", "ZB SMTP Provider", "ZB Did You Mean"
"exampleemail@example.com", "FirstName LastName", "2", "valid", "", "yokristi51", "exampledomain.com,", "", "", "", "True", "true", "xxxxl-smtp-in.l.xxxxxxx.com", "google", ""'

If the request was made via Postman we can download the results as .CSV file from the following:

HTTP request
ZeroBounce: https://bulkapi.zerobounce.net/v2/getfile?api_key=ReplaceWithYourApiKey&file_id=ReplaceWithYours

HTTP request
NeverBounce: https://api.neverbounce.com/v4/jobs/download?key=ReplaceWithYours&job_id=ReplaceWithYours

Account info/ Get balance

NeverBounce
URL
GET
https://api.neverbounce.com/v4.2/account/info

GET
API DEFAULT URL: https://api.zerobounce.net/v2/getcredits API U.S.A. URL*:
https://api-us.zerobounce.net/v2/getcredits
Request
Params
• key

Params
• api_key
Response
Example of successful response:
{
"status": "success",
"subscription_type": "pay_as_you_go",
"job_counts": { "completed": 0, "under_review": 0, "queued": 1, "processing": 0 },
"credits_info": { "paid_credits_used": 0, "free_credits_used": 0, "paid_credits_remaining": 0, "free_credits_remaining": 0 },
"execution_time": 45
}

Example of successful response:
{
"Credits": "1752"
}

Examples:

HTTP request

ZeroBounce:

API DEFAULT URL: https://api.zerobounce.net/v2/getcredits?api_key=ReplaceWithYourApiKey
API U.S.A. URL*: https://api-us.zerobounce.net/v2/getcredits?api_key=ReplaceWithYourApiKey

HTTP request
NeverBounce: https://api.neverbounce.com/v4.2/account/info?key=ReplaceWithYours

*This endpoint uses servers located within the United States. By utilizing this endpoint, you acknowledge and consent to your data being processed on servers in the United States.

NeverBounce

Validate/Verify a single email address:

NeverBounce
URL
GET
https://api.neverbounce.com/v4/single/check

GET
API DEFAULT URL:https://api.zerobounce.net/v2/validate
API U.S.A. URL*:https://api-us.zerobounce.net/v2/validate
API EU URL:https://api-eu.zerobounce.net/v2/validate
Request
• key
• email

• api_key
• email
• ip_address
Response
Response example:
{
"status": "success",
"result": "valid",
"flags": ["has_dns", "has_dns_mx"],
"suggested_correction": ""
"retry_token": "",
"execution_time": 499
}

Response example:
"address": "youremail@domain.com",
"status": "catch-all",
"sub_status": "",
"free_email": false,
"did_you_mean": null,
"account": "youremail",
"domain": "domain.com",
"domain_age_days": "11750",
"smtp_provider": "example",
"mx_found": "true",
"mx_record": "mxa-00*****.gslb.*****ted.com",
"firstname": null,
"lastname": null,
"gender": null,
"country": null,
"region": null,
"city": null,
"zipcode": null,
"processed_at": "2023-07-20 17:10:08.083"

Examples:

HTTP request

ZeroBounce:

API DEFAULT URL:https://api.zerobounce.net/v2/validate?api_key=ReplaceWithYourApiKey&email=ReplaceWithYours

API U.S.A. URL*:https://api-us.zerobounce.net/v2/validate?api_key=ReplaceWithYourApiKey&email=ReplaceWithYours

API EU URL: https://api-eu.zerobounce.net/v2/validate?api_key=ReplaceWithYourApiKey&email=ReplaceWithYours

HTTP request
NeverBounce: https://api.neverbounce.com/v4/single/check?key=ReplaceWithYours&email=ReplaceWithYours

*This endpoint uses servers located within the United States. By utilizing this endpoint, you acknowledge and consent to your data being processed on servers in the United States.

Verifying a list or ZeroBounce’s Batch validator

NeverBounce
URL
POST
https://api.neverbounce.com/v4/jobs/create

POST
https://api.zerobounce.net/v2/validatebatch
https://api-us.zerobounce.net/v2/validatebatch
https://api-eu.zerobounce.net/v2/validatebatch
Request
Body-type: form-data
• key
• input_location
• filename
• auto_start
• auto_parse
• input

Params
• api_key
• email
Response
Example of successful response:
{
"status": "success",
"job_id": YourJobId,
"execution_time": 503
}

Example of successful response:
{"email_batch": [{
"address": "valid@example.com",
"status": "valid",
"sub_status": "",
"free_email": false,
"did_you_mean": null,
"account": null,
"domain": null,
"domain_age_days": "9692",
"smtp_provider": "example",
"mx_found": "true",
"mx_record": "mx.example.com",
"firstname": "zero",
"lastname": "bounce",
"gender": "male",
"country": null,
"region": null,
"city": null,
"zipcode": null,
"processed_at": "2020-09-17 17:43:11.829"
}]}

ZeroBounce’s list/batch email validator provides the results in the response body directly without the need of creating a task/job.

Sending a CSV by URL / BulkApi Send file

NeverBounce
URL
POST
https://api.neverbounce.com/v4/jobs/create

POST
https://bulkapi.zerobounce.net/v2/sendfile
Request
Body-type: form-data
• key
• input_location
• filename
• auto_parse
• auto_start
• input

Body-type: form-data
• file
• api_key
• return_url
• email_address_column
• first_name_column
• last_name_column
• gender_column
• ip_address_column
• has_header_row
Response
Example of successful response:
{
"status": "success",
"job_id": YourJobId,
"execution_time": 503
}

Example of successful response:
{
"success": true,
"message": "File Accepted",
"file_name": "ExampleCSV2.csv",
"file_id": "55634bf2-872b-439c-8ac4-0c7xxxxxxxxx"
}

Checking the status of a bulk validation / File Status

NeverBounce
URL
GET
https://api.neverbounce.com/v4/jobs/status

GET
https://bulkapi.zerobounce.net/v2/filestatus
Request
Params
• key
• job_id

Params
• api_key
• file_id
Response
Example of successful response:
{
"status": "success",
"id": YourJobId,
"filename": "NBUser_1054_58f2b406006f1",
"created": "2017-04-15 20:00:06",
"started": "2017-04-15 20:00:21",
"finished": "2017-04-15 21:52:46",
"total_records": 24606,
"total_billable": 24606,
"total_processed": 24606,
"total_valid": 18227,
"total_invalid": 1305,
"total_catchall": 4342,
"total_disposable": 16,
"total_unknown": 716,
"total_duplicates": 0,
"total_bad_syntax": 0,
"bounce_estimate": 5.3035844915874,
"percent_complete": 100,
"job_status": "complete",
"execution_time": 2535
}

Example of successful response:
{
"success": true,
"file_id": "YourFileID",
"file_name": "YourFile.csv",
"upload_date": "2023-07-27T10:37:55Z",
"file_status": "Complete",
"complete_percentage": "100%",
"error_reason": null,
"return_url": null
}

Example:

HTTP request
ZeroBounce: https://bulkapi.zerobounce.net/v2/filestatus?api_key=ReplaceWithYourApiKey&file_id=ReplaceWithYours

HTTP request
NeverBounce: https://api.neverbounce.com/v4/jobs/status?key=ReplaceWithYours&job_id=ReplaceWithYours

Retrieving the Results / Get File

NeverBounce
URL
GET
https://api.neverbounce.com/v4/jobs/download

GET
https://bulkapi.zerobounce.net/v2/getfile
Request
Params
• key
• job_id

Params
• api_key
• file_id
Response
Example of successful response:
"support@neverbounce.com", "Fred McValid", valid "invalid@neverbounce.com", "Bob McInvalid", invalid'

Example of successful response:
"Email Address", "Custom", "Custom", "Custom", "ZB Status", "ZB Sub Status", "ZB Account", "ZB Domain", "ZB First Name", "ZB Last Name", "ZB Gender", "ZB Free Email", "ZB MX Found", "ZB MX Record", "ZB SMTP Provider", "ZB Did You Mean"
"exampleemail@example.com", "FirstName LastName", "2", "valid", "", "yokristi51", "exampledomain.com,", "", "", "", "True", "true", "xxxxl-smtp-in.l.xxxxxxx.com", "google", ""'

If the request was made via Postman we can download the results as .CSV file from the following:

HTTP request
ZeroBounce: https://bulkapi.zerobounce.net/v2/getfile?api_key=ReplaceWithYourApiKey&file_id=ReplaceWithYours

HTTP request
NeverBounce: https://api.neverbounce.com/v4/jobs/download?key=ReplaceWithYours&job_id=ReplaceWithYours

Account info/ Get balance

NeverBounce
URL
GET
https://api.neverbounce.com/v4.2/account/info

GET
API DEFAULT URL: https://api.zerobounce.net/v2/getcredits API U.S.A. URL*:
https://api-us.zerobounce.net/v2/getcredits
Request
Params
• key

Params
• api_key
Response
Example of successful response:
{
"status": "success",
"subscription_type": "pay_as_you_go",
"job_counts": { "completed": 0, "under_review": 0, "queued": 1, "processing": 0 },
"credits_info": { "paid_credits_used": 0, "free_credits_used": 0, "paid_credits_remaining": 0, "free_credits_remaining": 0 },
"execution_time": 45
}

Example of successful response:
{
"Credits": "1752"
}

Examples:

HTTP request

ZeroBounce:

API DEFAULT URL: https://api.zerobounce.net/v2/getcredits?api_key=ReplaceWithYourApiKey
API U.S.A. URL*: https://api-us.zerobounce.net/v2/getcredits?api_key=ReplaceWithYourApiKey

HTTP request
NeverBounce: https://api.neverbounce.com/v4.2/account/info?key=ReplaceWithYours

*This endpoint uses servers located within the United States. By utilizing this endpoint, you acknowledge and consent to your data being processed on servers in the United States.