Get Profiles

get https://a.klaviyo.com/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

Query Params

additional-fields[profile]

array of strings

Request additional fields not included by default in the response. Supported values: 'subscriptions', 'predictive_analytics'

additional-fields[profile]

fields[profile]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sparse-fieldsets

fields[profile]

filter

string

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

include

array of strings

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#relationships

include

page[cursor]

string

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

page[size]

integer

1 to 100

Defaults to 20

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

sort

string

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

Headers

revision

string

required

Defaults to 2025-04-15

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

Responses

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://a.klaviyo.com/api/profiles?page[size]=20' \
3
     --header 'Authorization: Klaviyo-API-Key your-private-api-key' \
4
     --header 'accept: application/vnd.api+json' \
5
     --header 'revision: 2025-04-15'


xxxxxxxxxx
136
}
1
{
2
  "data": [
3
    {
4
      "type": "profile",
5
      "id": "01GDDKASAP8TKDDA2GRZDSVP4H",
6
      "attributes": {
7
        "email": "sarah.mason@klaviyo-demo.com",
8
        "phone_number": "+15005550006",
9
        "external_id": "string",
10
        "first_name": "Sarah",
11
        "last_name": "Mason",
12
        "organization": "Example Corporation",
13
        "locale": "en-US",
14
        "title": "Regional Manager",
15
        "image": "https://images.pexels.com/photos/3760854/pexels-photo-3760854.jpeg",
16
        "created": "2022-11-08T00:00:00+00:00",
17
        "updated": "2022-11-08T00:00:00+00:00",
18
        "last_event_date": "2022-11-08T00:00:00+00:00",
19
        "location": {
20
          "address1": "89 E 42nd St",
21
          "address2": "1st floor",
22
          "city": "New York",
23
          "country": "United States",
24
          "latitude": "string",
25
          "longitude": "string",

200Success

4XXClient Error

5XXServer Error