Docs
Docs
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
