Responses

All requests are performed via an HTTPS connection and responses are returned as JSON. All responses will contain a success parameter. This parameter will indicate whether the requested operation was successfully completed or if an error was encountered.

Always check the response status code to ensure the request was successfully received and successfully handled.

Success Response

All success responses follow the same schema:

Success Response

HTTP/1.1 200 OK

{
    "result": "deliverable",
    "message": "This address can receive emails.",    
    "email": "[email protected]",
    "user": "support",
    "domain": "bouncify.io",
    "accept_all": 2,
    "role": 1,
    "free_email": 0,
    "disposable": 0,
    "spamtrap": 0,
    "success": true
}

In the response, you’ll find the result parameter. This parameter will indicate the status of the email. Learn more about different result codes here.

Error Response

All error responses follow the same schema:

Error Response

HTTP/1.1 401 Unauthorized

{
   "success":"false",
   "result":"Invalid API Key"
}