v1

latestOpenAPI 3.1.0MIT2026-07-226711.2 KB

Validate Single Email Address

Validates a single email address and returns detailed validation results

get/v1/

Query parameters

apistring required

Example:API_KEY

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 https://help.debounce.com/understanding-results/result-codes/.

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.

send_transactional0 | 1

Is it suggested that you send transactional emails to the recipient or not (0: no, 1: yes).

did_you_meanstring

Suggested corrected email when a typo is detected.

success0 | 1 required

Is your call successful or not (0: no, 1: yes).

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
}