When querying profiles from Klaviyo’s API, it’s critical to know the profile’s detailed subscription status.
Subscriptions object in profile response body
The new profile response body now includes an object called “subscriptions.” This houses all of the data for the consent status for various channels for the profile.
The subscription object includes detailed information for each channel:
- Consent status (subscribed, never subscribed, unsubscribed)
- Timestamp
- Method
- Method detail
- Custom method detail
- Double opt-in (true/false)
- Global suppressions
- List suppressions
Easily manage subscribers
This new inclusion into the profile object enables more granular subscription management for your users. It allows you to quickly validate statuses and ascertain how and where subscription status was collected.
Want to stay in the know? Read more about the improvements we’re making to our APIs or join our developer community today.
Related content
Klaviyo news
Klaviyo data is now in Claude Jan 23, 2026
Bring your Klaviyo marketing and customer data into Anthropic’s Claude to analyze performance, uncover insights, and take action—without exporting data or rebuilding dashboards.
Klaviyo news
Introducing Segments from FunnelsJan 14, 2026
Turn marketing funnel analysis into actionable segments—without spreadsheets or rebuilding logic. Re-engage drop-offs and personalize faster with Segments from Funnels by Klaviyo.
Klaviyo news
Locale aware catalogs: sync Shopify Markets with KlaviyoJan 14, 2026
Sync localized product catalogs from Shopify Markets into Klaviyo to deliver accurate pricing, language, and products for every customer in every region.