Get Lists

GET {{baseUrl}}/api/lists/

Get all lists in an account. Filter to request a subset of all lists. Lists can be filtered by id, name, created, and updated fields. Returns a maximum of 10 results per page.

Rate limits:
Burst: 10/s
Steady: 150/m

Scopes: List Read

Request Params

KeyDatatypeRequiredDescription
fields[list]stringFor more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#sparse-fieldsets
filterstringFor more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#filtering&lt;br&gt;Allowed field(s)/operator(s):<br>name: any, equals<br>id: any, equals<br>created: greater-than<br>updated: greater-than
page[cursor]stringFor more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#pagination

HEADERS

KeyDatatypeRequiredDescription
revisionstring(Required) API endpoint revision (format: YYYY-MM-DD[.suffix])
Acceptstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;type&quot;:&quot;list&quot;,&quot;id&quot;:&quot;elit sint magna consequat&quot;,&quot;attributes&quot;:{&quot;name&quot;:&quot;et commodo esse&quot;,&quot;created&quot;:&quot;2022-11-08T00:00:00&quot;,&quot;updated&quot;:&quot;2022-11-08T00:00:00&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;http://GDUJwQpBFZPqJqRNfz.ykfiIPR,6fy,j3y4slAjYlIQ,iAt&quot;}},{&quot;type&quot;:&quot;list&quot;,&quot;id&quot;:&quot;ut proident adipisicing&quot;,&quot;attributes&quot;:{&quot;name&quot;:&quot;est eiusmod aute&quot;,&quot;created&quot;:&quot;2022-11-08T00:00:00&quot;,&quot;updated&quot;:&quot;2022-11-08T00:00:00&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;http://gAbfsbbf.mpieiyS6Lt-lbeU-B4Y0Ws4lE3oNDXGHV7N+IPejV,L2ZzuAX9OE-9xvao3GkxFZ&quot;}}],&quot;links&quot;:{&quot;self&quot;:&quot;http://gnbe.kfTgKYb3v&quot;,&quot;first&quot;:&quot;https://Mp.jqmgLUv2d2LWRN4IyIv59NTc1ZoWAefT,MR6,Ck&quot;,&quot;last&quot;:&quot;https://NUcAKu.qouQESZckjeIL1J5qWop0xwRCiJ8fn12K+l2QEWv&quot;,&quot;prev&quot;:&quot;https://wmiTuMUoVFLgYnBpKAWSNYmZnWLoyNX.vydlAb6YfDJ-5aonX2LEzUzn4HOCkrpiWLYLdCwF2qydORo&quot;,&quot;next&quot;:&quot;http://rioWRnLnEjHvMcqErM.ycwxW&quot;}}