{"openapi":"3.1.0","info":{"title":"StepOz Public API","version":"1.0.0","description":"Safe public endpoints for StepOz pricing, welcome-offer, and onboarding metadata. User tasks, households, locations, notifications, SMS logs, webhooks, readiness internals, and admin surfaces are intentionally excluded."},"servers":[{"url":"https://stepoz.ai","description":"StepOz marketing site"},{"url":"https://app.stepoz.ai","description":"StepOz app site"}],"tags":[{"name":"Commercial Public Surface","description":"Public pricing, referral-points, and onboarding metadata that is safe to expose."}],"paths":{"/api/v1/plans":{"get":{"tags":["Commercial Public Surface"],"summary":"List public StepOz plans","description":"Returns public plan definitions, public pricing labels, and StepOz Points reward rules. No user-specific subscription or billing data is exposed.","operationId":"getPublicPlans","responses":{"200":{"description":"Public StepOz plan surface","content":{"application/json":{"schema":{"type":"object","required":["currency","plans","referral_program"],"properties":{"currency":{"type":"string","enum":["USD"]},"launch_phase":{"type":"string"},"phone_verification_required":{"type":"boolean"},"starter_offer_code":{"type":"string"},"plans":{"type":"array","items":{"$ref":"#/components/schemas/PublicLaunchPlan"}},"referral_program":{"$ref":"#/components/schemas/StepOzPointsProgram"},"notes":{"type":"array","items":{"type":"string"}}}}}}}}}},"/api/v1/welcome-offer":{"get":{"tags":["Commercial Public Surface"],"summary":"Read the public Free Trial offer","description":"Returns the public Free Trial / welcome-offer definition used by StepOz onboarding. No private user data is exposed.","operationId":"getPublicWelcomeOffer","responses":{"200":{"description":"Public Free Trial offer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WelcomeOffer"}}}}}}}},"components":{"schemas":{"PriceOption":{"type":"object","required":["code","currency","interval","label"],"properties":{"code":{"type":"string"},"currency":{"type":"string","enum":["USD"]},"amount":{"type":["number","null"]},"interval":{"type":"string"},"label":{"type":"string"}}},"PublicLaunchPlan":{"type":"object","required":["code","name","badge","audience","best_for","main_copy","description","cta_label","price_options","benefits"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"badge":{"type":"string"},"audience":{"type":"string"},"best_for":{"type":"string"},"main_copy":{"type":"string"},"description":{"type":"string"},"cta_label":{"type":"string"},"task_credits_included":{"type":["integer","null"]},"family_seat_limit":{"type":"integer"},"standard_safety_reminders_included":{"type":"boolean"},"daily_check_in_included":{"type":"boolean"},"location_sharing_included":{"type":"boolean"},"sms_fallback_included":{"type":"boolean"},"family_dashboard_included":{"type":"boolean"},"voice_input_included":{"type":"boolean"},"task_history_included":{"type":"boolean"},"saved_preferences_included":{"type":"boolean"},"price_options":{"type":"array","items":{"$ref":"#/components/schemas/PriceOption"}},"benefits":{"type":"array","items":{"type":"string"}},"billing_copy":{"type":["string","null"]},"safety_boundary_copy":{"type":["string","null"]},"privacy_boundary_copy":{"type":["string","null"]},"annual_savings_copy":{"type":["string","null"]},"launch_status":{"type":"string"}}},"StepOzPointsProgram":{"type":"object","required":["name","summary","rewards","redemption_rules","special_rule"],"properties":{"name":{"type":"string"},"summary":{"type":"string"},"rewards":{"type":"array","items":{"type":"object","required":["event","points","label"],"properties":{"event":{"type":"string"},"points":{"type":"integer"},"label":{"type":"string"}}}},"redemption_rules":{"type":"array","items":{"type":"object","required":["code","points","label","value_copy","optional"],"properties":{"code":{"type":"string"},"points":{"type":"integer"},"label":{"type":"string"},"value_copy":{"type":"string"},"optional":{"type":"boolean"}}}},"special_rule":{"type":"object","required":["label","effective_referral_count","equivalent_redemption_code"],"properties":{"label":{"type":"string"},"effective_referral_count":{"type":"integer"},"equivalent_redemption_code":{"type":"string"}}},"anti_abuse_notes":{"type":"array","items":{"type":"string"}}}},"WelcomeOffer":{"type":"object","required":["code","name","coupon_type","phone_verification_required","task_credits","valid_days","main_copy","summary","description","included_features","upgrade_hint"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"coupon_type":{"type":"string"},"phone_verification_required":{"type":"boolean"},"task_credits":{"type":"integer"},"valid_days":{"type":"integer"},"main_copy":{"type":"string"},"summary":{"type":"string"},"description":{"type":"string"},"included_features":{"type":"array","items":{"type":"string"}},"upgrade_hint":{"type":"string"}}}}}}