Quick start

1. Get your API key

Sign up at dash.truval.dev — free tier includes 500 verifications/month, no credit card required.

2. Make your first call

curl https://api.truval.dev/v1/email/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com"}'

3. Read the response

{
  "email": "user@example.com",
  "valid": true,
  "status": "deliverable",
  "confidence": 0.97,
  "disposable": false,
  "role": false,
  "smtp_blocked": false,
  "suggestion": null,
  "latency_ms": 187
}

Field	What it means
valid	true if the address passed all checks
status	deliverable — SMTP confirmed. unknown — can’t probe (Gmail etc). invalid — failed a check.
confidence	0–1 score. 0.97 = SMTP confirmed. 0.75 = domain real, provider blocks probing.
smtp_blocked	true for Gmail, Outlook, Yahoo — they block SMTP probing from all third parties. This is normal.
suggestion	Typo correction — "gnail.com" returns "gmail.com"

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer sk_live_...

Keys are generated in your dashboard.

Rate limits

Plan	Limit
Free	10 req/min
Builder	100 req/min
Scale	1,000 req/min