Email verification API
Send one HTTP request, get one answer: valid, invalid, risky or unknown. Use it on sign-up forms, in your CRM or in a no-code tool before you send to an address.
- Included in paid plans
- One credit per address
- No email is ever sent
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
"https://mailbite.io/api/v1/[email protected]"The mail server is asked whether the mailbox exists, but no message is ever sent, so the recipient never knows. One address costs one credit.
{
"status": "ok",
"email": "[email protected]",
"result": "valid",
"reason": "accepted",
"role": false,
"free_provider": false,
"disposable": false,
"typo_suggestion": null,
"credits_charged": 1,
"credits_left": 24999,
"request_id": "6f1c2c1e-0b0e-4d3a-9d52-3f6c2a9f4b11"
}What you get back
| result | valid, invalid, risky or unknown |
| reason | why, for example accepted, mailbox_not_found, no_mx_record, disposable_domain or accept_all |
| role | true for role addresses such as info@ or support@ |
| free_provider | true for free webmail such as Gmail or Outlook |
| disposable | true for temporary addresses |
| typo_suggestion | a likely correction such as gmail.com for gmial.com, or null |
| credits_charged, credits_left | what the request used and your balance afterwards |
| request_id | a unique id to quote if you need help |
Good to know
- Up to 1,500 requests per minute per key. Set a timeout of about 45 seconds: a slow mail server can take that long.
- One credit per verification, also for unknown. A malformed address (422) or a short outage (503) is free.
- Errors: 401 wrong key, 402 no credits, 403 API not in your plan, 429 too many requests.
Full reference and code samples are in your account under API. Public files: OpenAPI file · Postman collection
Questions
Is the API free?
API access is included in every paid plan. You can try single checks free on the home page, without an account.
Does it send an email to the address?
No. It asks the receiving mail server whether the mailbox exists and stops before any message is sent.
What does unknown mean?
The mail server gave no reliable answer. Retry later or treat the address with care. It still uses a credit.