Docs
MailVet API documentation
Everything you need to verify emails from your own code: one REST API, JSON responses, bearer keys and published limits. No login needed to read.
Guides and reference
- QuickstartKey, first request, first result in two minutes.
- Verify an emailGET /v1/verify: parameters, response fields, pending checks.
- Bulk listsCreate jobs, watch progress, download filtered results.
- WebhooksEvents, payloads and signature checks.
- Rate limitsPer-endpoint limits and the headers that report them.
- ErrorsError codes, HTTP statuses and when to retry.
- Result statusesEvery result and reason code the API returns.
Basics
| Base URL | https://api.mailvet.app/v1 |
| Auth | Authorization: Bearer mv_live_… (test keys start mv_test_ and never use credits) |
| Format | JSON responses, UTF-8, ISO 8601 timestamps in UTC |
| Results | deliverable, undeliverable, risky, unknown, each with a reason code |
| Billing | 1 credit per email with a definite result. Unknown and invalid syntax are free. |
| Limits | 2,000 single-verify requests per second per account, see /docs/rate-limits |