Get Profile

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

Get the profile with the given profile ID.

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 include=list parameter in your API request:
Burst: 1/s
Steady: 15/m

Rate limits when using the include=segment parameter in your API request:
Burst: 1/s
Steady: 15/m

To learn more about how the include parameter impacts rate limits, check out our Rate limits, status codes, and errors guide.

Scopes:
profiles:read

Path Params

string

required

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[list]

array of strings

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

fields[list]

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]

fields[push-token]

array of strings

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

fields[push-token]

fields[segment]

array of strings

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

fields[segment]

include

array of strings

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

include

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/id \
3
     --header 'Authorization: Klaviyo-API-Key your-private-api-key' \
4
     --header 'accept: application/vnd.api+json' \
5
     --header 'revision: 2025-04-15'


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

200Success

4XXClient Error

5XXServer Error