Per-tenant LTV prediction

GET

/api/v1/ml/ltv/{tenant_id}

• Production
• Local development

Return the latest LTV prediction for a single tenant (admin/owner).

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

tenant_id

required

string format: uuid

Responses

200

Successful Response

Output of the predictive LTV scoring model.

Attributes: tenant_id: Tenant this LTV score is for. ltv_amount: Predicted lifetime value in dollars, >= 0. segment: LTV segment classification. payback_months: Estimated months to recover acquisition cost. confidence: Model confidence, 0.0 to 1.0. cold_start: True if tenant has < 14 days of data. model_version: Version of the model used. computed_at: When this LTV was computed.

object

cold_start

required

boolean

computed_at

required

string format: date-time

confidence

required

number

<= 1

ltv_amount

required

number

model_version

required

integer

payback_months

Any of:

number

number

null

null

segment

required

string

Allowed values: high_value standard at_risk

tenant_id

required

string format: uuid

422

Validation Error

object

detail

Array<object>

object

ctx

object

input

loc

required

Array

msg

required

string

type

required

string