Get all the lists | Brevo API Documentation

Ongoing changes for this endpoint.

We’re dropping support for the response attributes totalSubscribers and totalBlacklisted.

These are non breaking changes. The default value for the attributes will be 0.

<Note> Ongoing changes for this endpoint. We're dropping support for the response attributes totalSubscribers and totalBlacklisted. These are non breaking changes. The default value for the attributes will be 0. </Note>

Authentication

api-keystring

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

Query parameters

limitlongOptionalDefaults to 10

Number of documents per page

offsetlongOptionalDefaults to 0

Index of the first document of the page

sortenumOptionalDefaults to desc

Sort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

Allowed values:

Response

Lists informations

countlong or null

Number of lists in your account

listslist of objects or null

Listing of all the lists available in your account

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

1	{
2	"count": 2,
3	"lists": [
4	{
5	"folderId": 1,
6	"id": 53,
7	"name": "Spanish_Speakers",
8	"totalBlacklisted": 65,
9	"totalSubscribers": 5432,
10	"uniqueSubscribers": 5497
11	},
12	{
13	"folderId": 2,
14	"id": 50,
15	"name": "Other",
16	"totalBlacklisted": 765,
17	"totalSubscribers": 10976,
18	"uniqueSubscribers": 11741
19	}
20	]
21	}

Authentication

Query parameters

Response

Errors