Veille

Email Qualification

GET
/v1/intelligence/emailq

Deep email deliverability verification. Performs full Email Validation plus SMTP inbox check, catch-all detection, and returns a qualification verdict (valid, invalid, risky, disposable, unknown).

Credit cost: 5 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

The email address to qualify (e.g. john@example.com). Automatically normalized to lowercase.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
dns?
email?string
domain?string
is_alias?boolean
education?boolean
role_type?string
disposable?boolean
risk_score?integer
smtp_valid?boolean
did_you_mean?unknown
has_gravatar?boolean
relay_domain?boolean
role_account?boolean
public_domain?boolean
qualification?string
normalized_email?string
Example Request
curl -X GET 'https://api.veille.io/v1/intelligence/emailq?query=string'
Example Response
{  "dns": {    "mx": true,    "spf": "v=spf1 include:spf.protection.outlook.com -all",    "dmarc": "v=DMARC1; p=reject; rua=mailto:dmarc@airbus.com",    "spf_valid": true,    "mx_records": [      {        "hostname": "airbus-com.mail.protection.outlook.com",        "priority": 10      }    ],    "dmarc_valid": true,    "mx_providers": [      {        "slug": "microsoft",        "type": "mailbox",        "grade": "professional"      }    ]  },  "email": "contact@airbus.com",  "domain": "airbus.com",  "is_alias": false,  "education": false,  "role_type": "contact",  "disposable": false,  "risk_score": 10,  "smtp_valid": true,  "did_you_mean": null,  "has_gravatar": false,  "relay_domain": false,  "role_account": true,  "public_domain": false,  "qualification": "valid",  "normalized_email": "contact@airbus.com"}