Skip to content
/
List HBL events

List HBL events

Request

List events for monitored HBL entities

Security
basicAuth
Query
domainstring

Filter by domain

hbl_typestring

Filter by HBL type

entitystring

Filter by HBL entity (e.g. an email address); the hbl_type must be provided, too

startstring, (date)

Start of the date range to filter events by, in YYYY-MM-DD format. Defaults to 7 days ago

endstring, (date)

End of the date range to filter events by, in YYYY-MM-DD format

include_subaccountsboolean

Include subaccounts

Default:false
limitintegerrequired

Limits the number of items returned in a request

curl -i -X GET \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v1/monitoring/hbls/events?domain=string&hbl_type=string&entity=string&start=2019-08-24&end=2019-08-24&include_subaccounts=false&limit=0'

Responses

A 200 response

Bodyapplication/json
eventsArray of objects(Domain_Blocklist_Monitoring_github.com-mailgun-dbl_monitor-internal-model-HBLHistoryRecord)required
pagingobject(Domain_Blocklist_Monitoring_github.com-mailgun-dbl_monitor-internal-api-PagingResponse)required
Response
{
  "events": [
    { … },
    { … }
  ],
  "paging": {}
}