Domain Email: Order Download File
Use this API endpoint to pay for and download a file containing all available email addresses for a specific domain. The request is processed asynchronously. You can provide a webhook URL to be notified once the file is ready. Note: the emails in this file are not verified and may require validation before use.
Endpoint
https://api.anymailfinder.com
/v5.1/domain/{domain}/email/orderPricing
- 1 credit is charged for every 40 emails.
The file provides raw, unverified data, so you may need to validate the emails before use.
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/domain/{domain}/email/order" \-H "Authorization: YOUR_API_KEY"
Request parameters
Path parameters
| Parameter | Example value | Description |
|---|---|---|
domainstring | "microsoft.com" | The domain for which to retrieve the email count and cost. |
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
The file has been successfully ordered and is now being prepared for download.
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.