Skip to content
Mailgun Inspect/API Documentation/
/
List Supported ESP Provid...

Email Preview API (1.0.0)

Mailgun Email Preview service with RESTful JSON HTTP API for providing email previews.

Download OpenAPI description
openapi-final.json
openapi-final.yaml
Languages
Servers
US Mailgun
https://api.mailgun.net
EU Mailgun
https://api.eu.mailgun.net

Image Validation

The Image Validation API processes image URLs or uploads to provide comprehensive details such as dimensions, type, file size, and format, reports frame count, animation duration, color depth, and transparency for GIFs, and include image optimization capabilities.

Operations

Accessibility

The Accessibility API evaluates HTML emails against WCAG standards, providing a clear pass/fail assessment to ensure compliance with accessibility guidelines.

Operations

Code Analysis

The Code Analysis API analyzes HTML email content to detect CSS features and provides comprehensive compatibility reports across major email clients, including support statistics, version-specific compatibility data, and detailed feature breakdowns to ensure optimal email rendering.

Operations

Email Preview

This API provides functionality to create and manage email preview tests, as well as create shareable links.

Operations

Spam Testing

The Spam Testing API scores inbox placement by submitting email content to seed accounts across major providers, reporting deliverability, spam filter verdicts, and authentication results to help maximize inbox reach.

Operations

Delete Spam Test (V1)

Request

Permanently deletes the spam test and its results.

Security
basicAuth
Path
spam_test_idstringrequired

ID of the spam test to delete

curl -i -X DELETE \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/inspect/spam/{spam_test_id}'

Responses

A 200 response

Bodyapplication/json
messagestringrequired

Response message

Response
application/json
{
  "message": "Spam test '67a654ba0f53254b9fdca3e2' deleted successfully"
}

List Supported ESP Providers

Request

Returns the static list of ESPs supported by spam testing, grouped by category (B2C / B2B).

Security
basicAuth
curl -i -X GET \
  -u <username>:<password> \
  https://api.mailgun.net/v1/inspect/spam/providers

Responses

A 200 response

Bodyapplication/json
metaobject(github.com-mailgun-inspect-internal-spam-ResponseMeta)required
meta.​request_idstringrequired
meta.​timestampstringrequired
meta.​countinteger or null(int32)
paginggithub.com-mailgun-scaffold-httpapi-paging-PagingResponse (object) or null
Any of:
itemsArray of objects(github.com-mailgun-inspect-internal-spam-ProviderInfo)required
items[].​domainstringrequired
items[].​display_namestringrequired
items[].​categorystringrequired
linksobject(github.com-mailgun-inspect-internal-spam-ResponseLinks)required
links.​selfstringrequired
Response
application/json
{
  "meta": {},
  "items": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ],
  "links": {}
}