# Email Verification API for AI Agents — Ravn

Canonical: https://askravn.com/features/email-verification-api

Email verification API

# Know it lands before you send.

Check one address or a thousand. Every verdict comes with the checks behind it and an A–F risk score, so your agent knows what to send, what to hold and what to drop.
[Start free: 1,000 lookups](https://askravn.com/#start) [Read the docs](https://askravn.com/docs#validate_email)

How it works
## What happens on every call.
The same tool answers over the REST API, the MCP server and the CLI.

- / 01
### Syntax and normalisation
Bad formats, stray spaces and lookalike characters are caught first, and the address is normalised so duplicates collapse to one verdict.
- / 02
### Domain and MX
We resolve the domain and its mail servers. No MX record means no mail, so the address is invalid, whatever it looks like.
- / 03
### Disposable, role and free-provider flags
Burner domains, role inboxes like info@ and sales@, and free providers are flagged so you can filter them by policy.
- / 04
### Catch-all detection
Some domains accept mail for any address. We test for it and mark the verdict risky instead of pretending a guess is valid.
- / 05
### Mailbox check where enabled
When mailbox checks are on, we ask the mail server about the exact address. If we did not test it, `mailbox_checked` says false and the verdict never claims valid.

Call it
## One request. One answer shape.
Branch on `status`. A miss returns `not_found` and costs nothing. In Claude, just ask in plain English and it picks `validate_email` for you.

```
curl https://api.askravn.com/v1/tools/validate_email \
-H "Authorization: Bearer $RAVN_API_KEY" \
-d '{"email": "jane@acme.com"}'

{ "status": "ok",
"results": { "email": "jane@acme.com", "status": "valid", "risk_score": "A",
"reason": "mailbox_exists", "disposable": false, "role_account": false,
"catch_all": false, "mailbox_checked": true },
"metadata": { "lookups_used": 1 } }
```

FAQ
## Questions about validate_email.
[All questions →](https://askravn.com/faq)
How is this different from a regex?A regex only checks the shape. We check the domain, its mail servers, burner and role lists and catch-all behaviour, and score the result A to F.Can I verify a whole list?Yes. `validate_emails` takes up to 1,000 addresses per call and returns one verdict per unique address. For CSVs, `npx ravn enrich leads.csv --tool validate_email --column Email` resumes if it stops.What do the risk scores mean?Every verdict has a 0–100 score graded A (90+) to F. A and B are safe to send, C means send with care (often a catch-all), D and F should be dropped.Does verification cost extra?No. Email checks count as lookups in your plan. Ravn is $24 a month with 10,000 lookups included, then $1 per 1,000, and a miss gives the lookup back.

## More tools, same key.
Every tool shares one account, one plan and one answer shape. [See pricing →](https://askravn.com/pricing)

- [Hashed Email Audiences for Meta & Google AdsTurn a verified customer list into SHA-256 hashed audiences for Meta Custom Audiences and Google Customer Match.](https://askravn.com/features/hashed-email-audiences)
- [IP to Company Lookup API: Identify B2B VisitorsFind the company behind an IP address from public registry data.](https://askravn.com/features/ip-to-company)
- [Lead Verification API: Email, Phone & CompanyVerify a whole lead in one call: email, phone, live company website and whether the person is listed there.](https://askravn.com/features/lead-verification-api)
- [People Search API: Find B2B Contacts by TitleSearch people by title, company, location, seniority and company size, with verified work emails.](https://askravn.com/features/people-search-api)
- [Phone Validation & Carrier Lookup APIValidate phone numbers and check the live carrier and line type: mobile, landline or VoIP.](https://askravn.com/features/phone-validation-api)
- [Reverse Email Lookup API: Email to PersonTurn an email into a business profile: name, title, company, location and LinkedIn.](https://askravn.com/features/reverse-email-lookup)