Skip to main content

GET /api/v1/customers//unified-profile

Returns a comprehensive profile for a customer, aggregating data from multiple sources into named sections. Supports selective section loading for performance.

Path Parameters

ParameterTypeDescription
customerIdstringCustomer identifier

Query Parameters

ParameterTypeRequiredDescription
formatstringNoSet to structured to return the new structured profile format with demographics, interactions, clv, metrics, and suppressions sections. If omitted, the legacy section-based format is used.
sectionsstringNoComma-separated list of sections to include (legacy format only). If omitted, all sections are returned.

Available Sections

SectionDescription
identitiesIdentity links (email, phone, device IDs) with confidence scores
interactionsRecent interaction history (last 20 events)
segmentsCustomer segment memberships
journeysActive and completed journey enrollments
experimentsExperiment variant assignments
consentConsent and preference records

Example

Response

Extension Point

Custom profile sections can be registered server-side via the profile-section extension API. This allows plugins and extensions to contribute additional data to the unified profile.

Roles

admin, editor, viewer See also: Customers | Identity | Profiles