Events

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

WARNING: This API is deprecated in favor of our Logs API.

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. See Filter expression for details about filtering expressions

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

Enum Value Description
yes

Sort by ascending time

no

Do not sort

limit
integer <= 300

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. See Tracking Failures

Enum Value Description
temporary

Mailgun could not deliver the email to the recipient email server, but will retry

permanent

Mailgun could not deliver the email to the recipient email server, and will drop the message without retrying sending.

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.