Skip to content

Verify a single email

Verify a single email address in real time.

GET /v1/verify

Request

Parameter	In	Required	Description
`email`	query	Yes	The email address to verify.
`timeout`	query	No	Max seconds to wait for the mail server (default `[N]`).

curl "https://api.verifymaill.com/v1/verify?email=jane@example.com" \
  -H "Authorization: Bearer sk_your_api_key"

const params = new URLSearchParams({ email: "jane@example.com" });
const res = await fetch(`https://api.verifymaill.com/v1/verify?${params}`, {
  headers: { Authorization: `Bearer ${process.env.VERIFYMAIL_API_KEY}` },
});
const result = await res.json();

import os, requests

res = requests.get(
    "https://api.verifymaill.com/v1/verify",
    params={"email": "jane@example.com"},
    headers={"Authorization": f"Bearer {os.environ['VERIFYMAIL_API_KEY']}"},
)
result = res.json()

Response

{
  "email": "jane@example.com",
  "status": "deliverable",
  "sub_status": null,
  "score": 96,
  "disposable": false,
  "role": false,
  "free": false,
  "accept_all": false,
  "did_you_mean": null,
  "domain": "example.com",
  "mx_record": "mail.example.com"
}

Response fields

Field	Type	Description
`email`	string	The address that was checked.
`status`	string	Headline verdict — see statuses.
`sub_status`	string \| null	Specific reason — see sub-statuses.
`score`	number	Quality score, 0–100.
`disposable`	boolean	Throwaway provider.
`role`	boolean	Role address (e.g. `info@`).
`free`	boolean	Free consumer provider.
`accept_all`	boolean	Domain accepts all mail.
`did_you_mean`	string \| null	Typo suggestion, if any.

See also

Understanding results
Bulk jobs for verifying many addresses
Errors