Verify Email
Verification
Verify Email
Verify a single email address
POST
Verify Email
Verify a single email address synchronously. Results are returned immediately and cached for 24 hours.Documentation Index
Fetch the complete documentation index at: https://docs.mailbreeze.com/llms.txt
Use this file to discover all available pages before exploring further.
Request Body
The email address to verify.
Examples
Response
The email address that was verified.
Verification result status:
clean- Email is valid and safe to send todirty- Email is invalid or riskyunknown- Could not determine validity
Example Response
The response is wrapped in an envelope with
success, data, and meta fields. SDKs automatically extract the data object, so you access fields directly (e.g., result.isValid).Result Categories
| Result | isValid | Description | Recommendation |
|---|---|---|---|
valid | true | Email exists and accepts mail | Safe to send |
invalid | false | Mailbox doesn’t exist | Do not send |
risky | false | May exist but has risk factors | Review manually |
unknown | false | Could not verify | Proceed with caution |
Risk Factors
Emails may be marked asrisky for:
- Disposable email - Temporary addresses that expire
- Role accounts - Generic addresses like admin@, support@
- Catch-all domains - Accept any address, can’t verify mailbox
- High spam complaint domain - Domain has poor reputation
Credits
- New verification: 1 credit deducted
- Cached result: 0 credits (results cached 24 hours)
Errors
| Code | HTTP Status | Description |
|---|---|---|
INVALID_EMAIL | 400 | Email format is invalid |
INSUFFICIENT_CREDITS | 402 | Not enough verification credits |