> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kaireonai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Profiles

> Unified customer profile aggregating data from all schema tables.

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/{customerId}

Get the unified profile for a customer.

### Path Parameters

| Parameter    | Type   | Required | Description         |
| ------------ | ------ | -------- | ------------------- |
| `customerId` | string | Yes      | Customer identifier |

### Example

```bash theme={null}
curl "https://playground.kaireonai.com/api/v1/profiles/C-1234" \
  -H "X-Tenant-Id: my-tenant"
```

### Response

```json theme={null}
{
  "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"
  }
}
```

<Tip>
  This endpoint is used by the Customer Viewer UI and the AI assistant's customer lookup tool.
</Tip>