curl --request POST \
--url https://apix.spotzee.com/api/ext/generic/email/email-validation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data 'email=<string>'import requests
url = "https://apix.spotzee.com/api/ext/generic/email/email-validation"
payload = { "email": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/x-www-form-urlencoded"
}
response = requests.post(url, data=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/x-www-form-urlencoded'
},
body: new URLSearchParams({email: '<string>'})
};
fetch('https://apix.spotzee.com/api/ext/generic/email/email-validation', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://apix.spotzee.com/api/ext/generic/email/email-validation"
payload := strings.NewReader("email=%3Cstring%3E")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/x-www-form-urlencoded")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"status": "success",
"data": {
"email": "test@example.com",
"result": "invalid",
"resultcode": 6,
"expanded_result": "no_mailbox",
"free": false,
"role": true,
"executiontime": 16,
"didyoumean": ""
}
}{
"status": "error",
"error": "Invalid request parameters"
}{
"status": "error",
"error": "Invalid request parameters"
}{
"status": "error",
"error": "Invalid request parameters"
}{
"status": "error",
"error": "Invalid request parameters"
}{
"status": "error",
"error": "Invalid request parameters"
}{
"status": "error",
"error": "Invalid request parameters"
}Validate email address
Checks email deliverability and returns a verdict, numeric result code, detailed reason and suggested correction when available. Code 2 is catch_all (the server accepts arbitrary recipients); code 6 is invalid. An inconclusive check is unknown, not proof of an invalid mailbox. Service failures return an error response.
curl --request POST \
--url https://apix.spotzee.com/api/ext/generic/email/email-validation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data 'email=<string>'import requests
url = "https://apix.spotzee.com/api/ext/generic/email/email-validation"
payload = { "email": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/x-www-form-urlencoded"
}
response = requests.post(url, data=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/x-www-form-urlencoded'
},
body: new URLSearchParams({email: '<string>'})
};
fetch('https://apix.spotzee.com/api/ext/generic/email/email-validation', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://apix.spotzee.com/api/ext/generic/email/email-validation"
payload := strings.NewReader("email=%3Cstring%3E")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/x-www-form-urlencoded")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"status": "success",
"data": {
"email": "test@example.com",
"result": "invalid",
"resultcode": 6,
"expanded_result": "no_mailbox",
"free": false,
"role": true,
"executiontime": 16,
"didyoumean": ""
}
}{
"status": "error",
"error": "Invalid request parameters"
}{
"status": "error",
"error": "Invalid request parameters"
}{
"status": "error",
"error": "Invalid request parameters"
}{
"status": "error",
"error": "Invalid request parameters"
}{
"status": "error",
"error": "Invalid request parameters"
}{
"status": "error",
"error": "Invalid request parameters"
}Authorizations
Bearer token authentication. Use format: Bearer YOUR_API_KEY
Body
Email address
Response
Successfully validated email address
Indicates successful operation
success Hide child attributes
Hide child attributes
"test@example.com"
Validation result
valid, catch_all, unknown, disposable, invalid "invalid"
Numeric result code (1=valid, 2=catch_all, 3=unknown, 4=error, 5=disposable, 6=invalid). Code 4 represents a failed check and returns an error response, not a successful verification. Code 6 alone does not identify a DNS error or timeout; inspect expanded_result for details.
6
Detailed verification reason. This is an open-ended string, for example no_mailbox or connection_timeout.
"no_mailbox"
Whether email is from a free email provider
false
Whether email is a role-based address (info@, support@, etc.)
true
Execution time reported by the validation service, preserved unchanged. May be zero.
16
Suggested correction for typos
""
Was this page helpful?