Events

Mailgun keeps track of every inbound and outbound message event and stores this data for at least 3 days.

Retrieves a paginated list of events

get/v3/{domain_name}/events

Mailgun tracks every inbound and outbound message event and retains this data for at least 3 days.

SecuritybasicAuth
Request
path Parameters
domain_name
required
string

Filter by sending domain

query Parameters
begin
string

The beginning of the search time range in epoch seconds

end
string

The end of the search time range in epoch seconds

ascending
string

Sort direction by time. Must be provided if the range end time is not specified. Can be either yes or no

limit
integer

The number of entries to return (300 max)

event
string

Filter by event type

list
string

Filter by mailing list email address that message was originally sent to

attachment
string

Filter by the name of an attached file

from
string

Filter by email address mentioned in the From MIME header

message-id
string

Filter by Mailgun message id returned by the messages API

subject
string

Filter by subject line

to
string

Filter by email address mentioned in the To MIME header

size
string

Filter by message size. Mostly intended to be used with range filtering expressions

recipient
string

Filter by email address of a recipient. While messages are addressable to one or more recipients, each event (with one exception) tracks one recipient. See stored events for use of recipients

recipients
string

Specific to stored events, this field tracks all of the potential message recipients.

tags
string

Filter by user defined tags

severity
string

Filter by event severity, if exists. Currently for failed events only. Can be either temporary or permanent

Responses
200

OK

Response Schema: application/json
Array of objects
object
Request samples 
Response samples 
application/json
{
  • "items": [
    • {
      }
    ],
  • "paging": {}
}
Cookie PolicyGDPR Email ComplianceAcceptable Use PolicyTerms of ServicePrivacy Policy
© 2024 Sinch Mailgun. All rights reserved.