All data is received as JSON.

Each response sent from the API contains a success parameter which is of 0/1 type, indicating whether the request was successful or not (successful is 1 and unsuccessful is 0). Upon success being 0, an optional error parameter (string) may be given. In case of success is 1, the response is always contained within a debounce parameter.

Success Response

All success responses follow the same schema:

HTTP/1.1 200 OK

{
   "debounce":{
      "email":"[email protected]",
      "code":"5",
      "role":"false",
      "free_email":"true",
      "result":"Safe to Send",
      "reason":"Deliverable",
      "send_transactional":"1",
      "did_you_mean":""
   },
   "success":"1",
   "balance":"1725935"
}

Error Response

All error responses follow the same schema:

HTTP/1.1 401 Unauthorized

{
   "debounce":{
      "error":"Wrong API",
      "code":"0"
   },
   "success":"0"
}