Catalog/commerce-trial-conversion-value

Commerce

Free-trial conversion value API

Estimates expected revenue from a cohort of trial starts given a conversion rate, monthly price, and expected lifetime, net of trial cost, plus value per trial start. Answers 'What is a free trial worth?', 'What is the expected value per trial start?'.

Price$0.02per request
MethodPOST
Route/v1/commerce/trial-conversion-value
StatusLive
MIME typeapplication/json
Rate limit120/minute
Cache0s public
commercesubscriptionfree-trialconversionsaasltvcohortvalue
API URLhttps://x402.hexl.dev/v1/commerce/trial-conversion-value
Integration docs
Example request
{
  "trialStarts": 1000,
  "conversionRate": 0.2,
  "monthlyPrice": 50,
  "expectedLifetimeMonths": 12,
  "costPerTrial": 2
}
Example response
{
  "trialStarts": 1000,
  "conversionRate": 0.2,
  "expectedConversions": 200,
  "ltvPerConvertedCustomer": 600,
  "grossExpectedRevenue": 120000,
  "totalTrialCost": 2000,
  "netExpectedValue": 118000,
  "valuePerTrialStart": 118,
  "interpretation": "200 expected conversions × $600 LTV = $120000 gross; net $118000 ($118/trial start)."
}
Input schema
{
  "type": "object",
  "required": [
    "trialStarts",
    "conversionRate",
    "monthlyPrice",
    "expectedLifetimeMonths"
  ],
  "properties": {
    "trialStarts": {
      "type": "number",
      "examples": [
        1000
      ]
    },
    "conversionRate": {
      "type": "number",
      "examples": [
        0.2
      ]
    },
    "monthlyPrice": {
      "type": "number",
      "examples": [
        50
      ]
    },
    "expectedLifetimeMonths": {
      "type": "number",
      "examples": [
        12
      ]
    },
    "costPerTrial": {
      "type": "number",
      "examples": [
        2
      ]
    }
  }
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}