GET /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

Servers

Path parameters

Name Type Required Description
id String Yes

Request headers

Name Type Required Description
revision String Yes

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

Default value: "2025-07-15"

Query parameters

Name Type Required Description
additional-fields[profile][] Array No

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

include[] Array No

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

fields[push-token][] Array No

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

fields[profile][] Array No

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

fields[segment][] Array No

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

fields[list][] Array No

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

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. 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.
  3. Click Test request to test run your request to the API and see the API's response.