Skip to main content

Get subscriber data in profiles API

David Henriquez
1 min read
Klaviyo news
March 8, 2023
Set as Preferred Source

Understand profile subscription data

Generated by Klaviyo AI

The article explains how subscriber consent data is now exposed in the profiles API via a dedicated subscriptions object. It outlines the fields available for each channel and how this enables more granular subscription management and validation.

  • Subscriptions object: Profiles API responses now include a subscriptions object containing consent data for each communication channel.
  • Detailed consent fields: Each channel’s subscription entry includes consent status, timestamp, method, method detail, custom method detail, double opt-in flag, and suppression information.
  • Suppression tracking: The subscriptions object records both global suppressions and list-level suppressions for more precise control.
  • Granular management: Access to detailed subscription metadata enables more granular management of user subscriptions and validation of how and where consent was collected.

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.

David Henriquez
David Henriquez

Related content

Klaviyo news
Nov 19, 2026
The Klaviyo Oracle OPERA Cloud integration is here
onnect Oracle OPERA Cloud to Klaviyo to sync guest profiles, reservations, and loyalty data, then trigger pre-arrival, in-stay, and post-stay hotel journeys.
Klaviyo news
Nov 18, 2026
Composer mobile and more
Composer, Klaviyo’s AI marketing agent, is now on iOS and Android. See what the Composer mobile app can do, then train Customer Agent and use channel affinity.
Klaviyo news
Nov 17, 2026
New Klaviyo BFCM Updates: Composer, Customer Agent, and More
Composer now builds campaigns from the brief in your docs, Customer Agent remembers shoppers across channels, and 4 more updates speed up approvals, organization, sending, and translation before Black Friday Cyber Monday.