Skip to content
Mailgun Optimize
/
Mailgun Optimize API Reference
/
DMARC Reports
/
Retrieve DMARC reporting data for a hostname.

Alerts (0.0.1)

Our alerting solution is centered around two concepts: events and channels. The occurrence of an event can be configured to trigger an alert. A channel describes the delivery method for an alert. Every configured alert consists of an event type / channel pair. This level of granularity allows alerting to be configured to your exact preference.

Download OpenAPI description
inboxready.json
inboxready.yaml
Languages
Servers
US Mailgun

https://api.mailgun.net/

EU Mailgun

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

Domains

Operations

DMARC Reports

DMARC reporting provides valuable insights into your infrastructure, helping you identify potential issues like senders, misconfigured email servers, or phishing attempts.

Operations

Retrieve DMARC reporting data from a specific source.

Request

Security
basicAuth
Path
domainstringrequired

Fully qualified domain name

Example: example.com
sourcestringrequired

User friendly source id name

Example: mailgun
Query
frominteger

UNIX epoch (UTC seconds) representing the start of the time range.

Example: from=1736790000
tointeger

UNIX epoch (UTC seconds) representing the end of the time range. If supplied, from must also be set.

Example: to=1736790285
curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/dmarc/domains/example.com/s/mailgun?from=1736790000&to=1736790285'

Responses

OK | Object representing DMARC info for a source

Bodyapplication/json
Response
application/json
{
  "email_count": "79,",
  "compliance_rate": 0.58,
  "ip_count": 2,
  "pfqr_chart": [
    { … },
    { … }
  ],
  "hostnames": [
    { … },
    { … }
  ],
  "auth_events": [
    { … }
  ]
}

Retrieve DMARC reporting data for a hostname.

Request

Security
basicAuth
Path
domainstringrequired

Fully qualified domain name

Example: example.com
sourcestringrequired

User friendly source id name

Example: mailgun
hoststringrequired

Host name

Example: mx.mailgun.com
Query
frominteger

UNIX epoch (UTC seconds) representing the start of the time range.

Example: from=1736790000
tointeger

UNIX epoch (UTC seconds) representing the end of the time range. If supplied, from must also be set.

Example: to=1736790285
curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/dmarc/domains/example.com/s/mailgun/h/mx.mailgun.com?from=1736790000&to=1736790285'

Responses

OK | Object representing DMARC info for a hostname

Bodyapplication/json
Response
application/json
{
  "email_count": "79,",
  "ip_count": 2,
  "spf_fail_events": 1,
  "dkim_fail_events": 1,
  "auth_fail_events": 1,
  "pfqr_chart": [
    { … },
    { … }
  ],
  "ip_addresses": [
    { … },
    { … }
  ],
  "auth_events": [
    { … }
  ]
}

Retrieve DMARC reporting data for an IP Address.

Request

Security
basicAuth
Path
domainstringrequired

Fully qualified domain name

Example: example.com
sourcestringrequired

User friendly source id name

Example: mailgun
hoststringrequired

Host name

Example: mx.mailgun.com
ipstringrequired

a valid IPv4 or IPv6 address

Example: 8.8.8.8
Query
frominteger

UNIX epoch (UTC seconds) representing the start of the time range.

Example: from=1736790000
tointeger

UNIX epoch (UTC seconds) representing the end of the time range. If supplied, from must also be set.

Example: to=1736790285
curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/dmarc/domains/example.com/s/mailgun/h/mx.mailgun.com/ip/8.8.8.8?from=1736790000&to=1736790285'

Responses

OK | Object representing DMARC info for an IP Address

Bodyapplication/json
Response
application/json
{
  "email_count": "79,",
  "ip_count": 2,
  "spf_fail_events": 1,
  "dkim_fail_events": 1,
  "auth_fail_events": 1,
  "ruf": "todo",
  "pfqr_chart": [
    { … },
    { … }
  ],
  "auth_events": [
    { … }
  ]
}

Inbox Placement

Inbox Placement testing allows you to see the likely deliverability of your email campaigns.

Operations

Bounce Classification

Operations

Spam Traps Monitoring

Our spam trap monitoring service surfaces how much of your email is being sent to known spam traps.

Operations

Email Health Score

Operations

IP Blocklist Monitoring

Operations

Domain Blocklist Monitoring

Blocklist Monitoring enables you to keep an eye on your reputation. Monitor your domains against our curated list of blocklist providers to make sure you aren't being blocked.

Operations

Google Postmaster Tools

This API provides access to Google Postmaster data.

Operations

Microsoft SNDS

This API provides access to Microsoft SNDS data.

Operations

Alerts

Operations