---
title: "Validate single email address"
method: GET
path: "/v1/"
---

# Validate single email address

`GET /v1/`

Validates a single email address and returns detailed validation results

## Query parameters

- `api` string, required
- `email` string, email, required
- `photo` boolean
- `append` boolean
- `gsuite` boolean

## Response `200`

Validation successful

- ValidationResult
  - `email` string, email, required — The email address you are requesting to validate.
  - `code` integer — DeBounce validation response code. To understand DeBounce results and codes, visit [this link](https://help.debounce.com/understanding-results/result-codes/).
  - `role` boolean — Is the email role-based or not. Role emails such as "sales@", "webmaster@" etc., are not suitable for sending marketing emails to.
  - `free_email` boolean — 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.
  - `reason` string — The reason why the result is given (view full reasons via [this link](https://help.debounce.com/understanding-results/result-codes/)).
  - `send_transactional` 0 | 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_mean` string — If you use a misspelled email address like someemail@gmial.com, the validation engine tries to suggest you the corrected email address.
  - `success` 0 | 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.
  - `balance` integer — Remaining balance on your account after the current API call.

## Other responses

- `401` — Invalid API Key
- `402` — Credits Low
- `429` — Too Many Requests / Daily Limit Reached

---

[API](https://skmtc.net/debounce/apis/debounce-email-validation-api.md) · [All operations](https://skmtc.net/debounce/apis/debounce-email-validation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debounce/debounce-email-validation-api/versions/f3f57e1a9fe2/schema)