Email Validation
Validate any email address in a single call. Detects disposable and temporary inboxes, verifies deliverability, identifies role accounts, public webmail, relay services, and returns a 0-100 risk score.
Credit cost: 5 credits per request
Authorization
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
query*string
The email address to validate (e.g. john@example.com). Automatically normalized to lowercase.
qualification_check?boolean
Enable deep deliverability verification. Checks whether the inbox actually exists, detects catch-all domains, and returns a qualification verdict (valid, invalid, risky, unknown). Increases latency by a few seconds.
Default
"false"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.veille.io/v1/email?query=string"{
"email": "user@tempmail.org",
"normalized_email": "user@tempmail.org",
"domain": "tempmail.org",
"disposable": true,
"education": false,
"public_domain": false,
"relay_domain": false,
"role_account": false,
"role_type": null,
"is_alias": false,
"did_you_mean": null,
"has_gravatar": false,
"dns": {
"mx": true,
"mx_records": [
{
"hostname": "mx1.tempmail.org",
"priority": 10
}
],
"spf": "v=spf1 include:_spf.tempmail.org ~all",
"spf_valid": true,
"dmarc": null,
"dmarc_valid": false
},
"smtp_valid": false,
"is_catch_all": false,
"qualification": "disposable",
"risk_score": 72
}{
"error": "Bad Request"
}{
"error": "Invalid API Key"
}{
"error": "Payment required"
}{
"error": "Rate limit exceeded for the API key: quota monthly"
}{
"error": "Internal Error"
}