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"}
| Property | Type | Description | ||||||
|---|---|---|---|---|---|---|---|---|
credits_charged | number | Number of credits charged for this request. | ||||||
email_status | string | The email status. One of the following:
|
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.
Refer to the Authentication page to ensure your API key is properly included.
{"error": "unauthorized","message": "Missing or invalid API key."}
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.