HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Get Profile IDs for List

Get profile membership relationships for a list with the given list ID.

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

Rate limits when using the additional-fields[profile]=predictive_analytics parameter in your API request:
Burst: 10/s
Steady: 150/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
profiles:read

Path Params
string
required

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

Query Params
string

For more information please visit https://developers.klaviyo.com/en/v2025-01-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
email: any, equals
phone_number: any, equals
push_token: any, equals
_kx: equals
joined_group_at: greater-or-equal, greater-than, less-or-equal, less-than

integer
1 to 100
Defaults to 20

Default: 20. Min: 1. Max: 100.

Headers
string
required
Defaults to 2025-01-15

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

Responses

Language
Credentials