HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Get List

Get a list with the given list ID.

Rate limits:
Burst: 75/s
Steady: 700/m

Rate limits when using the additional-fields[list]=profile_count parameter in your API request:
Burst: 1/s
Steady: 15/m

To learn more about how the additional-fields parameter impacts rate limits, check out our Rate limits, status codes, and errors guide.

Scopes:
lists:read

Path Params
string
required

Primary key that uniquely identifies this list. Generated by Klaviyo.

Query Params
array of strings

Request additional fields not included by default in the response. Supported values: 'profile_count'

additional-fields[list]
array of strings
fields[flow]
array of strings
fields[list]
array of strings
fields[tag]
array of strings
include
Headers
string
required
Defaults to 2025-01-15

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language
Credentials