GET /api/profiles

Get all profiles in an account.

Profiles can be sorted by the following fields in ascending and descending order: id, created, updated, email, subscriptions.email.marketing.suppression.timestamp, subscriptions.email.marketing.list_suppressions.timestamp

Use the additional-fields parameter to include subscriptions and predictive analytics data in your response.

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: profiles:read

Servers

https://a.klaviyo.com

Request headers

Name Type Required Description

Name	Type	Required	Description
`revision`	String	Yes	API endpoint revision (format: YYYY-MM-DD[.suffix]) Default value: "2025-04-15"

revision

String

Yes

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

Default value: "2025-04-15"

Query parameters

Name	Type	Required	Description
`include[]`	Array	No	For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#relationships
`filter`	String	No	For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#filtering Allowed field(s)/operator(s): `id`: `any`, `equals` `email`: `any`, `equals` `phone_number`: `any`, `equals` `external_id`: `any`, `equals` `_kx`: `equals` `created`: `greater-than`, `less-than` `updated`: `greater-than`, `less-than` `subscriptions.email.marketing.list_suppressions.reason`: `equals` `subscriptions.email.marketing.list_suppressions.timestamp`: `greater-or-equal`, `greater-than`, `less-or-equal`, `less-than` `subscriptions.email.marketing.list_suppressions.list_id`: `equals` `subscriptions.email.marketing.suppression.reason`: `equals` `subscriptions.email.marketing.suppression.timestamp`: `greater-or-equal`, `greater-than`, `less-or-equal`, `less-than`
`sort`	String	No	For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sorting Possible values: `"updated"` `"email"` `"created"` `"id"` `"-email"` `"-subscriptions.email.marketing.list_suppressions.timestamp"` `"subscriptions.email.marketing.suppression.timestamp"` `"-id"` `"-created"` `"subscriptions.email.marketing.list_suppressions.timestamp"` `"-subscriptions.email.marketing.suppression.timestamp"` `"-updated"`
`fieldsprofile[]`	Array	No	For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sparse-fieldsets
`pagesize`	Integer	No	Default: 20. Min: 1. Max: 100. Default value: 20
`additional-fieldsprofile[]`	Array	No	Request additional fields not included by default in the response. Supported values: 'subscriptions', 'predictive_analytics'
`pagecursor`	String	No	For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#pagination

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.