API Migration

EmailListVerify.com

1. Validate/Verify a single email address:

EmailListVerify.com
URL

GET

https://apps.emaillistverify.com/api/verifyEmail

GET

API DEFAULT URL:

https://api.zerobounce.net/v2/validate

API U.S.A. URL*:

https://api-us.zerobounce.net/v2/validate

Request
  • Secret (which is the API key)
  • email
  • api_key
  • email
  • ip_address
Response

Response is one of the below:

  • Ok
  • Fail
  • Unknown
  • Incorrect
  • Key_not_valid
  • Missing parameters

Response example:

"address": "s.krisztian@force.com",
"status": "catch-all",
"sub_status": "",
"free_email": false,
"did_you_mean": null,
"account": "s.krisztian",
"domain": "force.com",
"domain_age_days": "11750",
"smtp_provider": "proofpoint",
"mx_found": "true",
"mx_record": "mxa-00177002.gslb.pphosted.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

EmailListVerify: https://apps.emaillistverify.com/api/verifyEmail?secret=ReplaceWithYourApiKey&email=ReplaceWithYours

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

*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.

A detailed response like the one ZeroBounce offers is important to understand precisely why an email is valid, invalid or tagged as risky.

2. Bulk email validator - send file

EmailListVerify.com
URL

POST

https://apps.emaillistverify.com/api/verifApiFile?secret=YourApiKey

POST

https://bulkapi.zerobounce.net/v2/sendfile

Request

Body-type: form-data

  • secret
  • filename
  • file_contents

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
ResponseThe response we get contains the uploaded file ID and nothing else.

Example of successful response:

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

Only the bolded parameters are mandatory. Anything else is entirely optional and should not be included in the API request if they will be left blank.

3. Bulk Validation - Get file

EmailListVerify.com
URL

GET

https://apps.emaillistverify.com/api/getApiFileInfo

GET

https://bulkapi.zerobounce.net/v2/getfile

Request

Params

  • secret
  • id

Params

  • api_key
  • file_id
Response

Example

1992646|ExampleCSV2.csv|no|2|2|finished|1690276887|https://elv-files.s3.eu-central-1.amazonaws.com/2023-07/1b276aab8e876407a77dd1c1ab95***********.csv|https://elv-files.s3.eu-central-1.amazonaws.com/2023-07/1b276aab8e876407a77dd1c1ab95034****************f914_all.csv

Example

"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"
"xxkrxxxx1@domain.com", "FirstName", "LastName", "2", "valid", "", "xoxxxxx", "gmail.com", "", "", "","True", "true", "gmail-smtp-in.l.google.com", "google", "" "s.xxxxxxx@domainl.com", "Firstname", "Lastname", "0","valid", "", "s.xxxxxx", "domain.com", "", "", "", "True", "true", "mail.domain.com", "", ""

Examples:

HTTP request

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

HTTP request

EmailListVerify: https://apps.emaillistverify.com/api/getApiFileInfo?secret=ReplaceWithYours&id=ReplaceWithYours

NeverBounce

1. 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

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

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.

2. Verifying a list or ZeroBounce’s Batch validator

NeverBounce
URL

POST

https://api.neverbounce.com/v4/jobs/create

POST

https://bulkapi.zerobounce.net/v2/validatebatch

Request

Body-type: form-data

  • key
  • input_location
  • filename
  • auto_start
  • auto_parse
  • input

Params

  • api_key
  • email_batch
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.

3. 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"
}

4. 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
}

Examples:

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

5. 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

6. 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.

Kickbox

1. Validate/Verify a single email address:

Kickbox
URL

GET

https://api.kickbox.com/v2/verify

GET

API DEFAULT URL:

https://api.zerobounce.net/v2/validate

API U.S.A. URL*:

https://api-us.zerobounce.net/v2/validate

Request
  • apikey
  • email
  • timeout
  • api_key
  • email
  • ip_address
Response

response_example

"result": "deliverable",
"reason": "accepted_email",
"role": false,
"free": true,
"disposable": false,
"accept_all": false,
"did_you_mean": null,
"sendex": 1,
"email": "YourEmail",
"user": "YourExample",
"domain": "gmail.com",
"success": true,
"message": null

response_example

"address": "YourEmail",
"status": "catch-all",
"sub_status": "",
"free_email": false,
"did_you_mean": null,
"account": "youremail",
"domain": "domain.com",
"domain_age_days": "11750",
"smtp_provider": "******",
"mx_found": "true",
"mx_record": "mxa-0*****.gslb.*****ed.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

HTTP request

Kickbox: https://api.kickbox.com/v2/verify?apikey=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.

2. Validate email in batch/ ZeroBounce’s Batch validator

Kickbox
URL

PUT

https://api.kickbox.com/v2/verify-batch

POST

https://bulkapi.zerobounce.net/v2/validatebatch

Request

Params

  • apikey

Headers

  • X-Kickbox-Callback
  • X-Kickbox-Filename

Params

  • api_key
  • email_batch
Response

Example of successful response:

{
"id":123,
"success":true,
"message":null
}

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"
}]}

3. Kickbox’s batch validator via .csv upload / ZeroBounce’s Bulk email validator(via .csv files)

Kickbox
URL

PUT

https://api.kickbox.com/v2/verify-batch

POST

https://bulkapi.zerobounce.net/v2/sendfile

Request

Params

  • apikey

Headers

  • X-Kickbox-Callback
  • X-Kickbox-Filename

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:

{
"id":123,
"success":true,
"message":null
}

Example of successful response:

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

The return_url parameter is the equivalent of X-Kickbox-Callback header where the callback URL can be specified.

The URL will be used to call back when the validation is completed.

If a return_url was specified in the Multipart Form Data during the send file request, we will POST the following data to the URL when the validation process is complete.

4. Checking a Batch Verification Status / Bulk Email Validator File Status

Kickbox
URL

GET

https://api.kickbox.com/v2/verify-batch

GET

https://bulkapi.zerobounce.net/v2/filestatus

Request

Params

  • jobid
  • apikey

Params

  • api_key
  • file_id
Response

Example of successful response:

{
"id": 123,
"status": "starting",
"success": true,
"message": null
}

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
}

Examples:

HTTP request

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

HTTP request

Kickbox: https://api.kickbox.com/v2/verify-batch?jobid=ReplaceWithYours&apikey=ReplaceWithYours

BriteVerify

1. Account information / Get Credits

BriteVerify
URL

GET

https://bulk-api.briteverify.com/api/v3/accounts/credits

GET

API DEFAULT URL:

https://api.zerobounce.net/v2/getcredits

API U.S.A. URL*:

https://api-us.zerobounce.net/v2/getcredits

Request

Content-Type application/json

Authorization ApiKey

Params

  • api_key
Response

Example of successful response:

{
"credits": 2165,
"credits_in_reserve": 500,
"recorded_on": "2021-07-27T21:10:10.000+0000"
}

Example of successful response:

{
"Credits": "1752"
}

*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.

2. Validate/Verify a single email address

BriteVerify
URL

POST

https://bpi.briteverify.com/api/public/v1/fullverify

GET

API DEFAULT URL:

https://api.zerobounce.net/v2/validate

API U.S.A. URL*:

https://api-us.zerobounce.net/v2/validate

Request

Content-Type application/json

Authorization ApiKey
  • api_key
  • email
  • ip_address
Response

Response example:

{
"email": { "address": "Example@example.com", "account": "Example", "domain": "example.com", "status": "valid", "connected": null, "disposable": false, "role_address": true },
"duration": 0.035602396
}

Response example:

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

*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.

3. Bulk validator / Batch validator

BriteVerify’s bulk validator is the equivalent of ZeroBounce’s batch validator.

BriteVerify
URL

POST

https://bulk-api.briteverify.com/api/v3/lists

POST

https://bulkapi.zerobounce.net/v2/validatebatch

Request

Params

  • apikey

Headers

  • Authorization
  • Content-Type

Params

  • api_key
  • email_batch
Response

Example of successful response:

{
"status": "success",
"message": "created new list",
"list": { "id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "state": "open", "total_verified": 0, "total_verified_emails": 0, "total_verified_phones": 0, "page_count": 0, "progress": 0, "created_at": "08-10-2021 04:03 pm", "expiration_date": null, "results_path": null }
}

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"
}]}

Emailable

1. Validate/Verify a single email address

Emailable
URL

GET

https://api.emailable.com/v1/verify

GET

API DEFAULT URL:

https://api.zerobounce.net/v2/validate

API U.S.A. URL*:

https://api-us.zerobounce.net/v2/validate

Request

Params

  • apikey
  • email
  • smtp
  • accept_all
  • timeout

Params

  • api_key
  • email
  • ip_address
Response

Response example:

{
"accept_all": null,
"did_you_mean": null,
"disposable": false,
"domain": "gmail.com",
"duration": 0.493,
"email": "john.smith@gmail.com",
"first_name": "John",
"free": true,
"full_name": "John Smith",
"gender": "male",
"last_name": "Smith",
"mailbox_full": false,
"mx_record": "aspmx.l.google.com",
"no_reply": false,
"reason": "accepted_email",
"role": false,
"score": 100,
"smtp_provider": "google",
"state": "deliverable",
"tag": null,
"user": "john.smith"
}

Response example:

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

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

HTTP request

Emailable: https://api.emailable.com/v1/verify?email=ReplaceWithYours&api_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.

2. Batch email validator

Emailable
URL

PUT

https://api.emailable.com/v1/batch

POST

https://bulkapi.zerobounce.net/v2/validatebatch

Request

Params

  • api_key
  • emails
  • url
  • response_fields
  • retries
  • simulate

Params

  • api_key
  • email_batch
Response

Example of successful response:

{
"message": "Batch successfully created.",
"id": "YourJobId"
}

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"
}]}

The ZeroBounce Validate Batch endpoint allows you to validate batches of up to 100 emails simultaneously. To validate more you can use the Bulk email validator.

3. Account information / Get Credits

Emailable
URL

GET

https://api.emailable.com/v1/account

GET

API DEFAULT URL:

https://api.zerobounce.net/v2/getcredits

API U.S.A. URL*:

https://api-us.zerobounce.net/v2/getcredits

Request

Params

  • api_key

Params

  • api_key
Response

Example of successful response:

{
"owner_email": "john@smith.com",
"available_credits": 1337
}

Example of successful response:

{
"Credits": "1752"
}

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

Emailable: https://api.emailable.com/v1/account?api_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.