Skip to main content
The Profiles API returns a unified view of a customer by aggregating data from all configured schema tables, interaction history, and segment memberships.

​
GET /api/v1/profiles/

Get the unified profile for a customer.

​
Path Parameters

ParameterTypeRequiredDescription
customerIdstringYesCustomer identifier

​
Example

curl "https://playground.kaireonai.com/api/v1/profiles/C-1234" \
  -H "X-Tenant-Id: my-tenant"

​
Response

{
  "customerId": "C-1234",
  "schemas": {
    "customer": {
      "name": "John Smith",
      "email": "john@example.com",
      "tenure_months": 24,
      "segment": "high_value"
    },
    "account": {
      "account_type": "premium",
      "balance": 15000.00,
      "monthly_spend": 2500.00
    }
  },
  "segments": ["high_value", "digital_engaged"],
  "recentInteractions": [
    {
      "offerId": "offer_premium_card",
      "interactionType": "impression",
      "timestamp": "2026-03-18T09:00:00.000Z"
    }
  ],
  "identities": {
    "email": "john@example.com",
    "phone": "+1-555-0100"
  }
}
This endpoint is used by the Customer Viewer UI and the AI assistant’s customer lookup tool.