Skip to content
/
Lists monitored IP addres...

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
openapi-final.json
openapi-final.yaml
Languages
Servers
US Mailgun

https://api.mailgun.net/

EU Mailgun

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

Domains

Operations

Inbox Placement

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

Operations

Email Preview

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

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

Lists monitored IP addresses

Request

Security
basicAuth
Query
limitinteger

Limit

Default 100
curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/inboxready/ip_addresses?limit=100'

Responses

A 200 response

Bodyapplication/json
itemsArray of objects(Inbox_Ready_github.com-mailgun-inboxready-clients-medic-IPAddress)required
items[].​ipstringrequired
items[].​ip_poolstringrequired
items[].​descriptionstringrequired
items[].​statestringrequired
items[].​listedArray of objects(Inbox_Ready_github.com-mailgun-inboxready-clients-medic-Blacklist)required
items[].​listed[].​liststringrequired
items[].​listed[].​delist_requested_atstring(date-time)required
items[].​listed[].​first_seenstring(date-time)
items[].​listed[].​last_seenstring(date-time)required
items[].​listed[].​commentsArray of stringsrequired
items[].​listed[].​namestring
Response
application/json
{
  "items": [
    { … }
  ]
}

Register an IP address

Request

Security
basicAuth
Bodyapplication/jsonrequired
ipstringrequired
ip_poolstringrequired
descriptionstringrequired
curl -i -X POST \
  -u <username>:<password> \
  https://api.mailgun.net/v1/inboxready/ip_addresses \
  -H 'Content-Type: application/json' \
  -d '{
    "UpdateIPAddressReq": {}
  }'

Responses

A 201 response

Bodyapplication/json
ipstringrequired
ip_poolstringrequired
descriptionstringrequired
statestringrequired
listedArray of objects(Inbox_Ready_github.com-mailgun-inboxready-clients-medic-Blacklist)required
listed[].​liststringrequired
listed[].​delist_requested_atstring(date-time)required
listed[].​first_seenstring(date-time)
listed[].​last_seenstring(date-time)required
listed[].​commentsArray of stringsrequired
listed[].​namestring
Response
application/json
[
  {
    "ip": "127.0.0.1",
    "ippool": "swimming",
    "description": "this is a description",
    "state": "listed",
    "listed": [ … ]
  }
]

Get the IP address

Request

Security
basicAuth
Path
ipstringrequired

IP address

curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/inboxready/ip_addresses/{ip}'

Responses

A 200 response

Bodyapplication/json
ipstringrequired
ip_poolstringrequired
descriptionstringrequired
statestringrequired
listedArray of objects(Inbox_Ready_github.com-mailgun-inboxready-clients-medic-Blacklist)required
listed[].​liststringrequired
listed[].​delist_requested_atstring(date-time)required
listed[].​first_seenstring(date-time)
listed[].​last_seenstring(date-time)required
listed[].​commentsArray of stringsrequired
listed[].​namestring
Response
application/json
[
  {
    "ip": "127.0.0.1",
    "ippool": "swimming",
    "description": "this is a description",
    "state": "listed",
    "listed": [ … ]
  }
]

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