GET
/
v1
/
Validate single email address
curl --request GET \
  --url https://api.debounce.io/v1/
{
  "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"
}
If you require a profile photo along with the validation results, just add &photo=true at the end of the API endpoint. We will bill you 0.2 extra credits for each successful profile photo added. To find the full name and avatar of an email owner, you must add the &append=true in the validation endpoint and you will pay 2 extra credits for each successful data enrichment.

​
Important Note

If you are using this API in a sign-up form, you must consider
Deliverable, Accept-all, and Unknown statuses as valid,
so you do not miss out on new sign-ups.Another simple way is by checking the send_transactional parameter:If its value is 1, the email is eligible for being a new user.

Authorizations

​
api
string
query
required

API key for authentication

Query Parameters

​
api
string
required

Your Debounce 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). If your credits are zero or you have provided an invalid API key, you will receive a 0 response.

Available options:
0,
1
Example:

1

​
code
integer

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

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 (view full reasons via this link).

Example:

"Deliverable"

​
send_transactional
enum<integer>

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.

Available options:
0,
1
Example:

1

​
did_you_mean
string

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

Example:

""

​
balance
integer

Remaining balance on your account after the current API call.

Example:

4921