Email Verification
Use this endpoint to verify whether an email address is valid and deliverable. It performs advanced checks beyond standard SMTP validation, including detection of catch-all domains and temporary responses, to ensure high-accuracy, privacy-compliant verification.
Endpoint
https://api.anymailfinder.com
/v5.1/verify-emailPricing
- 0.2 credit: charged for every email verification, regardless of the result.
- Repeated verifications within the past 30 days are free.
Authentication
Include your API key using the Authorization header.
Refer to the Authentication page for setup instructions.
Code example
curl -X POST "https://api.anymailfinder.com/v5.1/verify-email" \-H "Content-Type: application/json" \-H "Authorization: YOUR_API_KEY" \-d '{"email": "john.doe@microsoft.com"}'
Request parameters
Send as JSON in the POST body:
| Parameter | Example value | Description |
|---|---|---|
emailstring | "john.doe@microsoft.com" | The email address to validate. |
Headers
| Parameter | Example value | Description |
|---|---|---|
x-webhook-urlstring - optional | "https://yourdomain.com/webhook" | If provided, the result will be POSTed to this URL instead of waiting for the response. |
Response
200OK
- Without webhook: The request responds once the search completes, returning the full result below.
- With webhook: The request returns immediately with 200 OK, and the result will be sent to the specified
x-webhook-urlvia POST.
{"credits_charged": 0.2,"email_status": "valid","mx_domain": "google.com","mx_host": "aspmx.l.google.com"}
| Property | Type | Description | ||||||
|---|---|---|---|---|---|---|---|---|
credits_charged | number | Number of credits charged for this request. | ||||||
email_status | string | The email status. One of the following:
| ||||||
mx_domain | string | null | The root domain of the MX hostname, e.g. google.com or outlook.com. null if mx_host is null. | ||||||
mx_host | string | null | The domain's primary MX hostname, or null if none found. |
400Bad Request
The request is missing required data or is improperly formatted.
Review the message field to identify and correct the issue.
{"error": "bad_request","message": "..."}
401Unauthorized
The request did not include a valid API key. If no key was sent at all, the message tells you to add the Authorization header instead.
Refer to the Authentication page to ensure your API key is properly included.
{"error": "unauthorized","message": "Invalid API key. Copy it again from https://app.anymailfinder.com/settings/api (if you regenerated it, use the new one)."}
402Payment Needed
Your account does not have enough credits to complete this request.
You can purchase additional credits to continue.
{"error": "upgrade_needed","message": "Your account does not have enough credits. Purchase more at https://app.anymailfinder.com/purchase."}
Need Help?
Our team is experienced with APIs and is here to help.
Chat with us.