Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-137825.6 KB

Validate single email address

Validates a single email address and returns detailed validation results

get/v1/

Query parameters

apistring required

Your DeBounce API key

emailstring email required

The email address you want to validate

photoboolean

If set to true, returns profile photo (extra credits apply)

appendboolean

If set to true, enriches with full name and avatar (extra credits apply)

gsuiteboolean

If set to true, detects G Suite accept-all emails

Response

Validation successful

emailstring email required

The email address you are requesting to validate.

codeinteger

DeBounce validation response code. To understand DeBounce results and codes, visit this link.

roleboolean

Is the email role-based or not. Role emails such as "sales@", "webmaster@" etc., are not suitable for sending marketing emails to.

free_emailboolean

Is the email from a free email provider - like Gmail - or not.

result'Invalid' | 'Risky' | 'Safe to Send' | 'Unknown' required

The final result of the validation process. This response will help to determine whether you should send marketing emails to a recipient or not.

reasonstring

The reason why the result is given (view full reasons via this link).

send_transactional0 | 1

Is it suggested that you send transactional emails to the recipient or not (0: no, 1: yes). Generally, it is suggested to send transactional emails to Valid, Accept-all, and Unknown emails.

did_you_meanstring

If you use a misspelled email address like someemail@gmial.com, the validation engine tries to suggest you the corrected email address.

success0 | 1 required

Is your call successful or not (0: no, 1: yes). If your credits are zero or you have provided an invalid API key, you will receive a 0 response.

balanceinteger

Remaining balance on your account after the current API call.

Example response

{
  "email": "test@example.com",
  "code": 1,
  "free_email": true,
  "result": "Safe to Send",
  "reason": "Deliverable",
  "send_transactional": 1,
  "success": 1,
  "balance": 4921
}