List contact predictive scores
Return the tenant’s per-contact predictive scores — churn risk, intent, propensity, LTV estimate and the derived health segment_label — with cursor pagination. Filter by segment_label and sort by any score column via sort (prefix - for descending; default churn_risk DESC), so the dashboard “At Risk” and “Champions” panels render without an N+1 back to each contact. On a transient read blip a last-known-good page is served with meta.degraded: true rather than a 5xx.
Authorizations
Dashboard JWT token from Clerk
Query Parameters
Filter to one health segment (champion, high_value_engaged, engaged, new, passive, at_risk, dormant, lost).
Sort column; prefix with - for descending (default -churn_risk).
Page size (1-100, default 25).
1 <= x <= 100Opaque pagination cursor from a previous page's meta.