Skip to content
/
Lookup allowlist record

Lookup allowlist record

Request

Fetch a single allowlist record to check if a given address or domain is present.

Security
basicAuth
Path
domain_namestringrequired

Domain to retrieve the allowlist entry from

valuestringrequired

The address to search for

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

Responses

A 200 response

Bodyapplication/json
typestringrequired

Type of allowlist

valuestringrequired

Domain or address allowlisted

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

Timestamp for when the entry was created in RFC822 format

reasonstringrequired

User-provided reason for allowlisting

Response
{
  "type": "domain",
  "value": "alice@example.com",
  "createdAt": "Thu, 11 Dec 2025 01:49:40 UTC",
  "reason": "why the record was created"
}