Get All Lists
Lists are static collections of Marketing Campaigns contacts. This API allows you to interact with the list objects themselves. To add contacts to a list, you must use the Contacts API.
You can also manage your lists using the Contacts menu in the Marketing Campaigns UI. For more information about lists and best practices for building them, see "Building your Contact List".
GET/v3/marketing/lists
Base url: https://api.sendgrid.com (The Twilio SendGrid v3 API)
This endpoint returns an array of all of your contact lists.
Property nameTypeRequiredDescription
Authorizationstring
required
Default:
Bearer <<YOUR_API_KEY_HERE>>
Property nameTypeRequiredDescription
page_sizenumber
Optional
Maximum number of elements to return. Defaults to 100, returns 1000 max
Default:
100
Minimum: 1
Maximum: 1000
page_tokenstring
Optional
200
SchemaExample
Property nameTypeRequiredDescriptionChild properties
resultarray[list]
Optional
Show result properties
_metadatametadata
Optional
Show _metadata properties
1const client = require("@sendgrid/client");2client.setApiKey(process.env.SENDGRID_API_KEY);34const queryParams = { page_size: 100 };56const request = {7url: `/v3/marketing/lists`,8method: "GET",9qs: queryParams,10};1112client13.request(request)14.then(([response, body]) => {15console.log(response.statusCode);16console.log(response.body);17})18.catch((error) => {19console.error(error);20});