Get the list of all the events for the received emails.

This endpoint will show the list of all the events for the received emails.

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Query parameters

senderstringOptional

Email address of the sender.

startDatestringOptionalformat: "datetime"

Mandatory if endDate is used. Starting date (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.SSSZ) from which you want to fetch the list. Maximum time period that can be selected is one month.

endDatestringOptionalformat: "datetime"

Mandatory if startDate is used. Ending date (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.SSSZ) till which you want to fetch the list. Maximum time period that can be selected is one month.

limitlongOptionalDefaults to 100

Number of documents returned per page

offsetlongOptionalDefaults to 0

Index of the first document on the page

sortenumOptionalDefaults to desc

Sort the results in the ascending/descending order of record creation

Allowed values:

Response

List of events for received emails.

eventslist of objects or null

1	import requests
2
3	url = "https://api.brevo.com/v3/inbound/events"
4
5	headers = {"api-key": "<apiKey>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"events": [
3	{
4	"date": "2017-03-11T12:30:00.000Z",
5	"recipient": "alexa@example.com",
6	"sender": "john@example.com",
7	"uuid": "1a825d56-029b-4a41-b8e4-1a825d56"
8	},
9	{
10	"date": "2017-03-12T12:30:00.000Z",
11	"recipient": "bob@example.com",
12	"sender": "alice@example.com",
13	"uuid": "1a825d56-029b-4a41-b8e4-61670463431b"
14	}
15	]
16	}

Authentication

Query parameters

Response

Errors