Skip to content
/
Lookup complaint record

Lookup complaint record

Request

Fetch a single complaint records to check if a given address is present in the list of complaints.

Security
basicAuth
Path
domain_namestringrequired

Domain to retrieve the complaint from

addressstringrequired

The address to search for

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

Responses

A 200 response

Bodyapplication/json
addressstringrequired

Email address for the original recipient

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

Timestamp for when the Complaint event was received in RFC822 format

Response
{
  "address": "alice@example.com",
  "created_at": "Thu, 11 Dec 2025 01:49:40 UTC"
}