Get unified customer profile
GET/customer360/profiles/{id}
Retrieves a single customer profile with full detail including health score, linked identities, and timeline event count. Use this when building the 360-degree view for a specific customer.
Request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | Integer ID of the customer profile to retrieve. Example: |
Responses
200 Full customer profile with related data
Content type application/json, object · CustomerProfileV1.
| Field | Type | Required | Description |
|---|---|---|---|
id | integer | No | Auto-incremented primary key. |
display_name | string | No | Full display name of the customer. Example: |
primary_email | string (email), nullable | No | Primary contact email address. Example: |
primary_phone | string, nullable | No | Primary phone number. Example: |
external_ids | object, nullable | No | Cross-system ID map (system name → external record ID). |
attributes | object, nullable | No | Arbitrary segmentation attributes. |
identities_count | integer | No | Number of linked identity records from external systems. Example: |
timeline_items_count | integer | No | Number of behavioural timeline events recorded for this profile. Example: |
health_score | object · CustomerHealthScoreV1 | No | A computed health score indicating the overall customer relationship quality. |
health_score.profile_id | integer | No | ID of the associated customer profile. Example: |
health_score.score | number | No | Numeric health score from 0 (worst) to 100 (best). Example: |
health_score.band | string | No | Human-readable health band derived from the score. Typical bands: 'healthy' (70–100), 'at_risk' (40–69), 'churned' (0–39). Example: |
health_score.status | string | No | Machine-readable health status. One of: |
health_score.factors | array of object | No | Scoring factor breakdown showing what drove the final score. |
health_score.factors[].factor | string | No | Name of the scoring dimension. |
health_score.factors[].weight | number | No | Relative weight of this factor in the overall score. |
health_score.factors[].value | number | No | Computed sub-score for this factor. |
health_score.calculated_at | string (date-time), nullable | No | Timestamp of the most recent score calculation. |
updated_at | string (date-time) | No | Last update timestamp. |
404 Profile not found
Example request
curl -X GET "https://{tenant}.faciotech.net/api/v1/customer360/profiles/{id}" \
-H "Accept: application/json"