Get Profile IDs for Segment

get

https://a.klaviyo.com/api/segments/{id}/relationships/profiles

Get all profile membership relationships for the given segment ID.

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

Scopes:
profiles:read
segments:read

Path Params

string

required

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

Query Params

filter

string

For more information please visit https://developers.klaviyo.com/en/v2026-01-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
profile_id: any, equals
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

page[cursor]

string

For more information please visit https://developers.klaviyo.com/en/v2026-01-15/reference/api-overview#pagination

page[size]

integer

1 to 100

Defaults to 20

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

sort

string

enum

For more information please visit https://developers.klaviyo.com/en/v2026-01-15/reference/api-overview#sorting

Allowed:

Headers

revision

string

required

Defaults to 2026-01-15

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

Responses

200Success

4XXClient Error

5XXServer Error