Docs
Docs
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
API EU URL:https://api-eu.zerobounce.net/v2/validate
Request
• Secret (which is the API key)
• api_key
• 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",
"catchall_domain": true,
"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&email=ReplaceWithYours
API EU URL: https://api-eu.zerobounce.net/v2/validate?api_key=ReplaceWithYourApiKey&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.
A detailed response like the one ZeroBounce offers is important to understand precisely why an email is valid, invalid or tagged as risky.
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
Response
The 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.
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", "", ""
Example:
HTTP request
ZeroBounce: https://bulkapi.zerobounce.net/v2/getfile?api_key=ReplaceWithYours&file_id=ReplaceWithYours
EmailListVerify: https://apps.emaillistverify.com/api/getApiFileInfo?secret=ReplaceWithYours&id=ReplaceWithYours
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
• api_key
• 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",
"catchall_domain": true,
"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.
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
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",
"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.829"
}]}
ZeroBounce’s list/batch email validator provides the results in the response body directly without the need of creating a task/job.
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"
}
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
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
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
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
API EU URL:
https://api-eu.zerobounce.net/v2/validate
Request
• apikey
• timeout
• api_key
• 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",
"catchall_domain": true,
"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
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.
Kickbox
URL
PUT
https://api.kickbox.com/v2/verify-batch
POST
https://api.zerobounce.net/v2/validatebatch
https://api-us.zerobounce.net/v2/validatebatch
https://api-eu.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",
"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.829"
}]}
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.
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
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
API EU URL:
https://api.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.
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
API EU URL:
https://api.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",
"catchall_domain": true,
"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.
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://api.zerobounce.net/v2/validatebatch
https://api-us.zerobounce.net/v2/validatebatch
https://api-eu.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",
"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.829"
}]}
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
API EU URL:
https://api-eu.zerobounce.net/v2/validate
Request
Params
• apikey
• email
• smtp
• accept_all
• timeout
Params
• api_key
• email_batch
• 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",
"catchall_domain": true,
"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&email=ReplaceWithYours
API EU URL: https://api-eu.zerobounce.net/v2/validate?api_key=ReplaceWithYourApiKey&email=ReplaceWithYours
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.
Emailable
URL
PUT
https://api.emailable.com/v1/batch
POST
https://api.zerobounce.net/v2/validatebatch
https://api-us.zerobounce.net/v2/validatebatch
https://api-eu.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",
"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.829"
}]}
The ZeroBounce Validate Batch endpoint allows you to validate batches of up to 200 emails simultaneously. To validate more you can use the Bulk email validator.
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.
