Verify an Email Address

Changed on

Check to see if an email address is real and retrieve additional metadata its overall quality.

get/verify

Request

  • Base URL
    https://api.kickbox.com/v2
  • URL
    https://api.kickbox.com/v2/verify
  • Auth
    none required

Query parameters

emailstring required

The email address to be validated, as a URL-encoded string.

timeoutinteger

Maximum time, in milliseconds, for the API to complete a verification request. Default: 6000, Maximum: 30000

apikeystring required

The API key to use to authenticate the call

Response

200

resultstring
reasonstring
roleboolean
freeboolean
disposableboolean
accept_allboolean
did_you_meanstring
sendexnumber
emailstring
userstring
domainstring
successboolean
messageunknown

Example response

{
  "result": "undeliverable",
  "reason": "rejected_email",
  "did_you_mean": "bill.lumbergh@gmail.com",
  "sendex": 0.23,
  "email": "bill.lumbergh@gamil.com",
  "user": "bill.lumbergh",
  "domain": "gamil.com",
  "success": true
}

Changes