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:

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

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.