Get all your transactional email activity (unaggregated events)

GET https://api.sendinblue.com/v3/smtp/statistics/events?days=11&messageId=202212281024.62341432715@smtp-relay.mailin.fr

This endpoint will show the aggregated stats for past 30 days by default if startDate and endDate OR days is not passed. The date range can not exceed 90 days

Request Params

KeyDatatypeRequiredDescription
limitnumberNumber limitation for the result returned
offsetnumberBeginning point in the list to retrieve from.
startDatestringMandatory if endDate is used. Starting date of the report (YYYY-MM-DD). Must be lower than equal to endDate
endDatestringMandatory if startDate is used. Ending date of the report (YYYY-MM-DD). Must be greater than equal to startDate
daysnumberNumber of days in the past including today (positive integer). Not compatible with 'startDate' and 'endDate'
emailstringFilter the report for a specific email addresses
eventstringFilter the report for a specific event type
tagsstringFilter the report for tags (serialized and urlencoded array)
messageIdstringFilter on a specific message id
templateIdnumberFilter on a specific template id
sortstringSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"events":[{"email":"john.smith@example.com","date":"2017-03-12T12:30:00.000Z","messageId":"\u003c201798300811.5787683@example.domain.com\u003e","event":"deferred","reason":"Error connection timeout","tag":"OrderConfirmation","from":"john@example.com","templateId":4},{"email":"john.smith@example.com","date":"2017-03-13T16:30:00.000Z","messageId":"\u003c201798300811.5787683@example.domain.com\u003e","event":"delivered","tag":"OrderConfirmation","from":"john@example.com","templateId":5}]}