Skip to content Skip to navigation Skip to topbar

Get All Lists

API Overview

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".

Operation overview

GET/v3/marketing/lists

Base url: https://api.sendgrid.com

This endpoint returns an array of all of your contact lists.

Operation details

Authentication

API Key

Headers

Property nameTypeRequiredDescription

Authorizationstringrequired

Default: Bearer <<YOUR_API_KEY_HERE>>

Query string

Property nameTypeRequiredDescription

page_sizenumberOptional

Maximum number of elements to return. Defaults to 100, returns 1000 max

Minimum: 1Maximum: 1000Default: 100

page_tokenstringOptional

Responses

200

SchemaExample

Property nameTypeRequiredDescriptionChild properties

resultarray[object]

Show child properties for result

_metadataobject

Show child properties for _metadata

Get All Lists

Node.js

Python

Java

PHP

Ruby

curl


_21const client = require('@sendgrid/client');
_21client.setApiKey(process.env.SENDGRID_API_KEY);
_21
_21const queryParams = {
_21  "page_size": 100
_21};
_21
_21const request = {
_21  url: `/v3/marketing/lists`,
_21  method: 'GET',
_21  qs: queryParams
_21}
_21
_21client.request(request)
_21  .then(([response, body]) => {
_21    console.log(response.statusCode);
_21    console.log(response.body);
_21  })
_21  .catch(error => {
_21    console.error(error);
_21  });