Report Bad Email

If an email returned by Anymail Finder as valid has bounced, you can use this endpoint to report it. This helps us investigate the issue and, when appropriate, refund credits back to your account.

Endpoint

POST
https://api.anymailfinder.com
/v5.1/report/bad-email

Pricing

This endpoint is free to 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/report/bad-email" \
-H "Content-Type: application/json" \
-H "Authorization: YOUR_API_KEY" \
-d '{
"email": "john.doe@microsoft.com",
"additional_info": "Email bounced with error: mailbox not found",
"bounce_message": "550 5.1.1 <john.doe@microsoft.com>... User unknown"
}'

Request parameters

Send as JSON in the POST body:

ParameterExample valueDescription
email
string
"john.doe@microsoft.com"The email address to report as bad.
additional_info
string
"Email bounced with error: mailbox not found"Additional information about why the email is bad.
bounce_message
string - optional
"550 5.1.1 <john.doe@microsoft.com>... User unknown"The bounce message received when trying to send to this email.

Response

200OK

The report was received and will be reviewed.

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.