Get List Profiles

GET {{baseUrl}}/api/lists/:list_id/profiles/

Get all profiles within a list with the given list ID. Filter to request a subset of all profiles. Profiles can be filtered by email, phone_number, and push_token fields. You can adjust the number of results per page via the page[size] query parameter, e.g. ?page[size]=25. Default: 20. Max: 100.

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

Scopes: List Read Profiles Read

Request Params

KeyDatatypeRequiredDescription
fields[profile]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>email: any<br>phone_number: any<br>push_token: any<br>_kx: equals
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;profile&quot;,&quot;id&quot;:&quot;aliquip sit veniam aliqua exercitation&quot;,&quot;attributes&quot;:{&quot;email&quot;:&quot;in adipisicing et&quot;,&quot;phone_number&quot;:&quot;anim nostrud Duis&quot;,&quot;external_id&quot;:&quot;magna commodo qui dolor&quot;,&quot;anonymous_id&quot;:&quot;in cillum fugiat&quot;,&quot;first_name&quot;:&quot;irure dolore dolor&quot;,&quot;last_name&quot;:&quot;veniam aute commodo elit&quot;,&quot;organization&quot;:&quot;non&quot;,&quot;title&quot;:&quot;dolor Duis in ut&quot;,&quot;image&quot;:&quot;veniam dolore&quot;,&quot;created&quot;:&quot;2022-11-08T00:00:00&quot;,&quot;updated&quot;:&quot;2022-11-08T00:00:00&quot;,&quot;last_event_date&quot;:&quot;2022-11-08T00:00:00&quot;,&quot;location&quot;:{&quot;address1&quot;:&quot;cillum dolore cupidatat sint aliquip&quot;,&quot;address2&quot;:&quot;ex veniam esse&quot;,&quot;city&quot;:&quot;dolor ad Duis aliquip&quot;,&quot;country&quot;:&quot;fugiat officia eu consequat ex&quot;,&quot;latitude&quot;:&quot;commodo&quot;,&quot;longitude&quot;:&quot;dolore dolor ea&quot;,&quot;region&quot;:&quot;voluptate&quot;,&quot;zip&quot;:&quot;ut est laboris Excepteur&quot;,&quot;timezone&quot;:&quot;esse dolor&quot;},&quot;properties&quot;:{}},&quot;links&quot;:{&quot;self&quot;:&quot;https://ARJKGeoyTWUNpL.wbzkcyeoMyjZWl5,-TWaaKjr+,mFRXQXnE0812m..U,vLRnQewytvxTJnmIa5a&quot;}},{&quot;type&quot;:&quot;profile&quot;,&quot;id&quot;:&quot;dolore nisi fugiat aute in&quot;,&quot;attributes&quot;:{&quot;email&quot;:&quot;et Ut&quot;,&quot;phone_number&quot;:&quot;sit anim nisi veniam proident&quot;,&quot;external_id&quot;:&quot;dese&quot;,&quot;anonymous_id&quot;:&quot;incididunt esse commodo dolore dolor&quot;,&quot;first_name&quot;:&quot;non sunt fugiat mollit consequat&quot;,&quot;last_name&quot;:&quot;sunt ullamco&quot;,&quot;organization&quot;:&quot;tempor pariatur mollit&quot;,&quot;title&quot;:&quot;in id proident veniam&quot;,&quot;image&quot;:&quot;labore Duis&quot;,&quot;created&quot;:&quot;2022-11-08T00:00:00&quot;,&quot;updated&quot;:&quot;2022-11-08T00:00:00&quot;,&quot;last_event_date&quot;:&quot;2022-11-08T00:00:00&quot;,&quot;location&quot;:{&quot;address1&quot;:&quot;consequat esse et aliqua&quot;,&quot;address2&quot;:&quot;a&quot;,&quot;city&quot;:&quot;qui&quot;,&quot;country&quot;:&quot;incididunt non consectetur anim&quot;,&quot;latitude&quot;:&quot;exercitation in aute qui&quot;,&quot;longitude&quot;:&quot;irure esse Duis&quot;,&quot;region&quot;:&quot;tempor aliquip&quot;,&quot;zip&quot;:&quot;adipisicing&quot;,&quot;timezone&quot;:&quot;veniam qui&quot;},&quot;properties&quot;:{}},&quot;links&quot;:{&quot;self&quot;:&quot;https://PvtEDAVdzdBdNmeyPWmsZBUS.sfMBh4gqK8SvE-sEunepHXObH-cxIGEYklt6NGBOsQHF2jhhuDb20HTp8DJdNxpd5&quot;}}],&quot;links&quot;:{&quot;self&quot;:&quot;https://yKByUeXQJRKiyvTCKtDxpEsbFrPtWGA.dhEwxvyGO4GjREmjHjFHo4.zucJ+8tGavHBeCsi,SiZhSP-OB0ErULj+z&quot;,&quot;first&quot;:&quot;http://khPATMrgvscs.jvD4CjeKqNQadH-Q7I&quot;,&quot;last&quot;:&quot;http://xbTwTuBpCHZRTZhUyjiBzDgmodDloRw.htpbfzgysTOMkrRBiknG0y.Xn16A4x5YmPLZTN1a&quot;,&quot;prev&quot;:&quot;https://JLXgRAkSKrXm.yiZssnFbBDjNtR&quot;,&quot;next&quot;:&quot;https://lfiXvVviXDgMATJUfnneTkf.zunkmtv,RojAKyf8Ow7mIJjgMLdTIPimR+HzSuk,QD18vaSOrGv-9sEP&quot;}}