Get List

get https://a.klaviyo.com/api/lists/{id}

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

additional-fields[list]

array of strings

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

additional-fields[list]

fields[flow]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sparse-fieldsets

fields[flow]

fields[list]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sparse-fieldsets

fields[list]

fields[tag]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sparse-fieldsets

fields[tag]

include

array of strings

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#relationships

include

Headers

revision

string

required

Defaults to 2025-04-15

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

Responses

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url https://a.klaviyo.com/api/lists/id \
3
     --header 'Authorization: Klaviyo-API-Key your-private-api-key' \
4
     --header 'accept: application/vnd.api+json' \
5
     --header 'revision: 2025-04-15'


xxxxxxxxxx
75
}
1
{
2
  "data": {
3
    "type": "list",
4
    "id": "Y6nRLr",
5
    "attributes": {
6
      "name": "Newsletter",
7
      "created": "2022-11-08T00:00:00+00:00",
8
      "updated": "2022-11-08T00:00:00+00:00",
9
      "opt_in_process": "double_opt_in",
10
      "profile_count": 0
11
    },
12
    "links": {
13
      "self": "string"
14
    },
15
    "relationships": {
16
      "profiles": {
17
        "links": {
18
          "self": "string",
19
          "related": "string"
20
        }
21
      },
22
      "tags": {
23
        "data": [
24
          {
25
            "type": "tag",

200Success

4XXClient Error

5XXServer Error