Skip to content
/
Lookup bounce record

Lookup bounce record

Request

Fetch a single bounce event by a given email address.

Security
basicAuth
Path
domain_namestringrequired

Domain to retrieve the bounce from

addressstringrequired

The address to search for

curl -i -X GET \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v3/{domain_name}/bounces/{address}'

Responses

A 200 response

Bodyapplication/json
addressstringrequired

Email address for the original recipient

codestringrequired

SMTP error code

errorstringrequired

SMTP error message

created_atobject(github.com-mailgun-mime-RFC822Time)required

Timestamp for when the Bounce event was received in RFC822 format

Response
{
  "address": "foo@bar.com",
  "code": "550",
  "error": "No such mailbox",
  "created_at": "Thu, 11 Dec 2025 01:49:40 UTC"
}