Skip to content

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.

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

Bulk Validations

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

Operations

Get Job V4

Request

Gets a selected job by list ID.

Security
basicAuth
Path
list_idstringrequired

The list ID being verified

Headers
X-Mailgun-Account-Idstringrequired

Mailgun Account ID

curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v4/address/validate/bulk/{list_id}' \
  -H 'X-Mailgun-Account-Id: string'

Responses

A 200 response

Bodyapplication/json
is_previewboolean
created_atinteger(int32)required
download_urlobject
idstringrequired
quantityinteger(int32)required
records_processedinteger(int32)required
statusstring
summaryobject
reasonstring
Response
application/json
{ "quantity": 10000, "id": "some-job-name", "summary": { "risk": {}, "result": {} }, "download_url": { "csv": "https://some-aws-or-gcp-host/file.csv.zip", "json": "https://some-aws-or-gcp-host/file.json.zip" }, "status": "uploaded", "created_at": 160000000 }

Delete Job V4

Request

Cancels a selected job by list ID.

Security
basicAuth
Path
list_idstringrequired

The list ID being verified

Headers
X-Mailgun-Account-Idstringrequired

Mailgun Account ID

curl -i -X DELETE \
  -u <username>:<password> \
  'https://api.mailgun.net/v4/address/validate/bulk/{list_id}' \
  -H 'X-Mailgun-Account-Id: string'

Responses

A 200 response

Bodyapplication/json
property name*objectadditional property
Response
application/json
{ "message": "Validation job canceled." }

List Jobs V4

Request

Returns all jobs.

Security
basicAuth
Headers
X-Mailgun-Account-Idstringrequired

Mailgun Account ID

curl -i -X GET \
  -u <username>:<password> \
  https://api.mailgun.net/v4/address/validate/bulk \
  -H 'X-Mailgun-Account-Id: string'

Responses

A 200 response

Bodyapplication/json
is_previewboolean
created_atinteger(int32)required
download_urlobject
idstringrequired
quantityinteger(int32)required
records_processedinteger(int32)required
statusstring
summaryobject
reasonstring
Response
application/json
{ "total": 2, "jobs": [ {}, {} ], "paging": { "prev": "http://localhost/v4/address/validate/bulk?limit=10&page=prev&pivot=", "first": "http://localhost/v4/address/validate/bulk?limit=10&page=first&pivot=", "last": "http://localhost/v4/address/validate/bulk?limit=10&page=last&pivot=", "next": "http://localhost/v4/address/validate/bulk?limit=10&page=next&pivot=" } }

List Health Preview

Operations