Domain Email: Get Count

Use this API endpoint to retrieve the number of emails available in the database for a specified domain and the cost to download the entire list.

Endpoint

GET

https://api.anymailfinder.com
/v5.1/domain/{domain}/email

Pricing

This endpoint is free to use.

Credits are only charged if you proceed to order the file.

Authentication

Include your API key using the Authorization header.
Refer to the Authentication page for setup instructions.

Code example

curl -X GET "https://api.anymailfinder.com/v5.1/domain/{domain}/email" \
  -H "Authorization: YOUR_API_KEY"

Request parameters

Path parameters

Parameter	Example value	Description
`domain` string	`"microsoft.com"`	The domain for which to retrieve email count and cost.

Response

200OK

The request was successful. The response provides the total number of emails available for the specified domain, the associated download cost in credits, and the current status of the download.

{
  "credits_required": 10689,
  "domain": "microsoft.com",
  "email_count": 427551,
  "status": null
}

Property	Type	Description
`credits_required`	integer	The number of credits required to download all emails for the domain.
`domain`	string	The requested domain.
`email_count`	integer	The total number of emails available in the database for this domain.
`status`	string \| null	The status of the requested file. One of the following: `null`: File not yet ordered. `queued`: File being prepared. `ready`: File ready to download.

400Bad Request

401Unauthorized

Need Help?

Our team is experienced with APIs and is here to help. Contact us via chat or email at team@anymailfinder.com.