Skip to content
Mailgun Validate
/
Mailgun Validate API Reference
/
Validations

Validations Service (1.0.0)

Mailgun Email Validation service with RESTful JSON HTTP API for performing email validation. This service also manages list and CSV ingestion used in bulk validation processing.

Download OpenAPI description
openapi-validate-final.json
openapi-validate-final.yaml
Languages
Servers
US Mailgun

https://api.mailgun.net/

EU Mailgun

https://api.eu.mailgun.net/

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
engagementobject(github.com-mailgun-validations-validation-engagement-EngagementData)
is_disposable_addressbooleanrequired
is_role_addressbooleanrequired
reasonArray of stringsrequired
resultstringrequired
riskstringrequired
root_addressstring
last_seeninteger(int32)
Response
application/json
{
  "address": "john_snow@yaho.com",
  "did_you_mean": "john_snow@yahoo.com",
  "engagement": {},
  "reason": [],
  "result": "deliverable",
  "risk": "low"
}

Bulk Validations

This API provides functionality to upload and manage bulk validation lists and previews.

Operations

List Health Preview

Operations