Per-tenant churn prediction
GET /api/v1/ml/churn/{tenant_id}
Return the latest churn prediction for a single tenant.
Platform-internal analytics over a customer tenant: admin/owner only,
matching the bulk /churn/scores sibling. Requires an active churn
model; if none has been trained yet, a 404 is returned so callers can
display a friendly ‘not yet trained’ message.
Authorizations
Parameters
Path Parameters
Responses
200
Successful Response
Output of the ML churn prediction model.
Attributes: tenant_id: Tenant this prediction is for. churn_probability: Probability of churn, 0.0 to 1.0. risk_level: Classification string (low/medium/high/critical). top_factors: Top contributing features with their weights. recommended_actions: Suggested retention actions. model_version: Version of the model that produced this prediction. confidence: Model confidence in this prediction, 0.0 to 1.0. cold_start: True if tenant has < 14 days of data. computed_at: When this prediction was computed.
object
A single feature’s contribution to a churn prediction.
object
422
Validation Error