Verify an Email

Check whether a specific email address exists and is safe to send to.

POST /api/v1/verify

Request

Field	Type	Required	Description
email	string	Yes	The email address to check.

Examples

cURL

curl https://app.bluauto.io/api/v1/verify \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"email":"john@acme.com"}'

Python

import requests

resp = requests.post(
    "https://app.bluauto.io/api/v1/verify",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"email": "john@acme.com"},
    timeout=60,
)
print(resp.json())   # { status, label, mx }

HTTP

POST /api/v1/verify HTTP/1.1
Host: app.bluauto.io
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{"email":"john@acme.com"}

Response

{ "status": "valid", "label": "Found", "mx": "Microsoft" }

Field	Description
status	The machine value. See status values.
label	The same wording shown in the app, for example Catch All.
mx	The mail provider behind the domain, or null if the domain has no mail records.

For the full list of status values and what they mean, see Responses & Status Values.