Skip to content
Mailgun Validate/
/Validations

Validations

This API provides functionality to validate single addresses, and managing thresholds.

Operations

Validate Address V4

Request

A single email address to validate.

Security
basicAuth
Query
addressstringrequired

The address to be validated

provider_lookupboolean

Enable/disable provider lookup, default is true

curl -i -X GET \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v4/address/validate?address=string&provider_lookup=true'

Responses

A 200 response

Bodyapplication/json
addressstringrequired
did_you_meanstring
engagementgithub.com-mailgun-validations-validation-engagement-EngagementData (object) or null
Any of:
is_disposable_addressbooleanrequired
is_role_addressbooleanrequired
reasonArray of stringsrequired
resultstringrequired
riskstringrequired
root_addressstring
last_seeninteger, (int32)
Response
{
  "address": "john_snow@yaho.com",
  "did_you_mean": "john_snow@yahoo.com",
  "engagement": {},
  "reason": [],
  "result": "deliverable",
  "risk": "low"
}