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.0/report/bad-email

Pricing

This endpoint is free to use.

Authentication

You must include your API key in the Authorization header to access this endpoint.
Refer to the Authentication page for details on how to authenticate your requests.

Code example

curl -X POST "https://api.anymailfinder.com/v5.0/report/bad-email" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 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

POST body parameters

Parameters should be sent as JSON in the POST Body.

Parameter	Example value	Description
`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

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.