Skip to main content
GET
/
v1
Validate Single Email Address
curl --request GET \
  --url 'https://api.debounce.io/v1/?api='
{
  "debounce": {
    "email": "someemail@gmail.com",
    "code": "5",
    "role": "false",
    "free_email": "true",
    "result": "Safe to Send",
    "reason": "Deliverable",
    "send_transactional": "1",
    "did_you_mean": ""
  },
  "success": "1",
  "balance": "329918"
}
You can enhance single email validation results by enabling additional options in the request.

​
Profile Photo

To include a profile photo (when available), add: 
&photo=true
This option adds 0.2 extra credits for each successful profile photo returned.

​
Data Enrichment (Full Name & Avatar)

To retrieve enriched contact details such as the user’s full name and avatar, include: 
&append=true
This option costs 2 extra credits for each successful enrichment response.

​
Important Usage Guidance

When using this API on a signup form, the following statuses should be treated as valid:
  • Deliverable
  • Accept-all
  • Unknown
This prevents rejecting legitimate new users.You may also rely on the send_transactional parameter:
  • If send_transactional = 1, the email is considered acceptable for user registration.

Authorizations

​
api
string
query
required

API key for authentication

Query Parameters

​
api
string
required

Your DeBounce API key

Example:

"API_KEY"

​
email
string<email>
required

The email address you want to validate

​
photo
boolean

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

​
append
boolean

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

​
gsuite
boolean

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

Response

Validation successful

​
email
string<email>
required

The email address you are requesting to validate.

Example:

"test@example.com"

​
result
enum<string>
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.

Available options:
Invalid,
Risky,
Safe to Send,
Unknown
Example:

"Safe to Send"

​
success
enum<integer>
required

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

Available options:
0,
1
Example:

1

​
code
integer

DeBounce validation response code. To understand DeBounce results and codes, visit https://help.debounce.com/understanding-results/result-codes/.

Example:

1

​
role
boolean

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

Example:

false

​
free_email
boolean

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

Example:

true

​
reason
string

The reason why the result is given.

Example:

"Deliverable"

​
send_transactional
enum<integer>

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

Available options:
0,
1
Example:

1

​
did_you_mean
string

Suggested corrected email when a typo is detected.

Example:

""

​
balance
integer

Remaining balance on your account after the current API call.

Example:

4921