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, which can be paginated with cursor-based pagination.

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/v2022-10-17/reference/api-overview#sparse-fieldsets
filterstringFor more information please visit https://developers.klaviyo.com/en/v2022-10-17/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/v2022-10-17/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&quot;,&quot;attributes&quot;:{&quot;name&quot;:&quot;proident nostrud eu ex mollit&quot;,&quot;created&quot;:&quot;1968-09-29T16:25:22.926Z&quot;,&quot;updated&quot;:&quot;1969-07-19T22:44:56.235Z&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;https://LamrS.ibeobf7eG-L9XgKwWz+w.fJ&quot;}},{&quot;type&quot;:&quot;list&quot;,&quot;id&quot;:&quot;reprehenderit quis commodo&quot;,&quot;attributes&quot;:{&quot;name&quot;:&quot;minim in labore eiusmod&quot;,&quot;created&quot;:&quot;1964-01-26T19:51:16.199Z&quot;,&quot;updated&quot;:&quot;1989-02-02T23:33:54.091Z&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;https://tujRuvvLjUNHNClPJCsxUuJOlGut.eapA+i2cz65Fw.LqHfJMJE8gXJYAR-vt4066eoLeEy6v9xQjVDGpVzZzWBwPD,hzkX6ZiDC&quot;}}],&quot;links&quot;:{&quot;self&quot;:&quot;http://gLagncsXWKxBkLCSkdGOKefqu.uddsNIGFiuLGaXdLGueBr,6n-BBNsrWWDr.NYjv2&quot;,&quot;first&quot;:&quot;https://SWWacBWPemYdIPbFOMOxSgrY.aegBFVAFCDiqqVA5ccubMWsN7SzlZynP9cQbwKQQVHWyFsCEFAW2UntDz.p&quot;,&quot;last&quot;:&quot;https://yekdBikosPdlOfqHYAhNA.cvwtTL-vNJK1aPT4R,8ZOpJ10wKK,9tqjDGgHc+PzQVc2HnUSC&quot;,&quot;prev&quot;:&quot;http://jFdYJtqdHRscXV.lttjNq4ejHLcsS6I&quot;,&quot;next&quot;:&quot;http://zvkiuniBpVpLAXWrMIGODWkiSia.bya6&quot;}}