Skip to content
Mailgun Optimize/
/
Domain Blocklist Monitori...

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

Inbox Placement

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

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

Get Monitored Domains

Request

Gets all domains that are being monitored for blocklisting

Security
basicAuth
Query
include_subaccountsboolean

Include subaccounts

Default false
curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/monitoring/domains?include_subaccounts=false'

Responses

A 200 response

Bodyapplication/json
domainsArray of objects(Domain_Blocklist_Monitoring_github.com-mailgun-dbl_monitor-model-HealthRecord)required
domains[].​domainstringrequired
domains[].​account_idstringrequired

Mailgun account ID.

domains[].​updated_atstring(date-time)required
domains[].​statestringrequired
domains[].​listedArray of objects(Domain_Blocklist_Monitoring_github.com-mailgun-dbl_monitor-model-Blocklist)required
domains[].​listed[].​liststringrequired
domains[].​listed[].​namestring
domains[].​listed[].​first_seenstring(date-time)
domains[].​listed[].​last_seenstring(date-time)
domains[].​listed[].​commentsArray of stringsrequired
Response
application/json
{
  "domains": [
    { … },
    { … }
  ]
}

Get All Events

Request

Get all events for all domains monitored

Security
basicAuth
Query
include_subaccountsboolean

Include subaccounts

Default false
curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/monitoring/domains/events?include_subaccounts=false'

Responses

A 200 response

Bodyapplication/json
eventsArray of objects(Domain_Blocklist_Monitoring_github.com-mailgun-dbl_monitor-model-HistoryRecord)required
events[].​timestampstring(date-time)required
events[].​eventstringrequired
events[].​domainstringrequired
events[].​account_idstringrequired
events[].​liststringrequired
events[].​namestring
pagingobject(Domain_Blocklist_Monitoring_github.com-mailgun-dbl_monitor-api-PagingResponse)required
paging.​previousstringrequired
paging.​firststringrequired
paging.​nextstringrequired
paging.​laststringrequired
Response
application/json
{
  "events": [
    { … },
    { … },
    { … }
  ],
  "paging": {}
}

Get Lists Domain is Listed in

Request

Get blocklists that the domain is listed in

Security
basicAuth
Path
domainstringrequired

The domain name

curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/monitoring/domains/{domain}/blocklists'

Responses

A 200 response

Bodyapplication/json
blocklistsArray of objects(Domain_Blocklist_Monitoring_github.com-mailgun-dbl_monitor-model-Blocklist)required
blocklists[].​liststringrequired
blocklists[].​namestring
blocklists[].​first_seenstring(date-time)
blocklists[].​last_seenstring(date-time)
blocklists[].​commentsArray of stringsrequired
Response
application/json
{
  "blocklists": [
    { … },
    { … }
  ]
}

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