EV vs Petrol Cost Calculator · Schema
Raw schema.
Same JSON the GET /v1/general-utility/ev-petrol-cost-calculator/schema endpoint returns — formatted for reading. Use it to codegen typed clients or document the contract.
{ "tool": "ev-petrol-cost-calculator", "domain": "general-utility", "version": "1.1.0", "name": "EV vs Petrol Cost Calculator", "description": "Compare the real ownership cost of an EV and a petrol vehicle using the numbers buyers already know: price, claimed range, mileage, local fuel rates, daily driving, currency and ownership period.", "standard": null, "inputs": [ { "key": "vehicle_type", "label": "Vehicle Type", "help": "Changes the default assumptions for insurance, service, charger cost and EV efficiency.", "type": "enum", "options": [ "car_suv", "scooter_bike" ], "default": "car_suv" }, { "key": "segment", "label": "Segment", "help": "Used for sensible price, service and efficiency defaults.", "type": "enum", "options": [ "small_car", "mid_suv", "large_suv", "scooter" ], "default": "mid_suv" }, { "key": "market", "label": "Market", "help": "Prefills currency, charging rate, fuel price, service cost and subsidy assumptions.", "type": "enum", "options": [ "india", "united_states", "europe", "united_kingdom", "canada", "australia" ], "default": "india" }, { "key": "currency", "label": "Currency", "type": "enum", "options": [ "INR", "USD", "EUR", "GBP", "CAD", "AUD" ], "default": "INR" }, { "key": "ev_onroad_price", "label": "EV On-road Price", "required": true, "unit": "currency", "type": "number", "min": 100, "max": 100000000, "step": 1000, "default": 1700000 }, { "key": "petrol_onroad_price", "label": "Petrol On-road Price", "required": true, "unit": "currency", "type": "number", "min": 100, "max": 100000000, "step": 1000, "default": 1200000 }, { "key": "ev_claimed_range_km", "label": "EV Claimed Range", "required": true, "unit": "km", "type": "number", "min": 20, "max": 1500, "step": 5, "default": 400 }, { "key": "petrol_mileage_kmpl", "label": "Petrol Mileage", "required": true, "unit": "km/L", "type": "number", "min": 5, "max": 120, "step": 0.5, "default": 15 }, { "key": "daily_distance_km", "label": "Daily Distance", "required": true, "unit": "km/day", "type": "number", "min": 1, "max": 500, "step": 1, "default": 40 }, { "key": "driving_pattern", "label": "Driving Pattern", "help": "Used for the real-world range correction note.", "type": "enum", "options": [ "city", "mixed", "highway" ], "default": "mixed" }, { "key": "electricity_rate_per_kwh", "label": "Electricity Rate", "required": true, "unit": "/kWh", "type": "number", "min": 0.01, "max": 5000, "step": 0.01, "default": 7.2 }, { "key": "petrol_price_per_litre", "label": "Petrol Price", "required": true, "unit": "/L", "type": "number", "min": 0.01, "max": 5000, "step": 0.01, "default": 106.5 }, { "key": "charging_mix", "label": "Charging Mix", "help": "Home uses your electricity rate. Mixed assumes 70% home and 30% public charging.", "type": "enum", "options": [ "home", "mixed", "public" ], "default": "home" }, { "key": "ownership_years", "label": "Ownership Period", "type": "enum", "options": [ "3", "5", "8" ], "default": "5" }, { "key": "real_world_range_factor", "label": "Real-world Range Factor", "required": true, "unit": "x", "help": "0.78 means the tool uses 78% of the brochure range.", "type": "number", "min": 0.5, "max": 1, "step": 0.01, "default": 0.78 }, { "key": "public_charging_rate_per_kwh", "label": "Public Charging Rate", "unit": "/kWh", "type": "number", "min": 0.01, "max": 5000, "step": 0.01, "default": 18 }, { "key": "home_charger_cost", "label": "Home Charger Cost", "unit": "currency", "type": "number", "min": 0, "max": 10000000, "step": 1000, "default": 15000 }, { "key": "ev_insurance_premium_pct", "label": "EV Insurance Premium", "unit": "%", "type": "number", "min": -50, "max": 100, "step": 1, "default": 12 }, { "key": "ev_service_cost_year", "label": "EV Service Cost", "unit": "currency/yr", "type": "number", "min": 0, "max": 10000000, "step": 500, "default": 6000 }, { "key": "petrol_service_cost_year", "label": "Petrol Service Cost", "unit": "currency/yr", "type": "number", "min": 0, "max": 10000000, "step": 500, "default": 18000 }, { "key": "ev_subsidy", "label": "EV Subsidy", "unit": "currency", "type": "number", "min": 0, "max": 10000000, "step": 1000, "default": 25000 } ], "outputs": [ { "key": "recommendation", "label": "Recommendation", "type": "string" }, { "key": "verdict", "label": "Verdict", "type": "string" }, { "key": "total_savings", "label": "EV Savings", "type": "number", "precision": 0 }, { "key": "break_even_years", "label": "Break-even", "type": "number", "unit": "yr", "precision": 2 }, { "key": "break_even_km", "label": "Break-even Distance", "type": "integer", "unit": "km" }, { "key": "ev_total_cost", "label": "EV Total Cost", "type": "number", "precision": 0 }, { "key": "petrol_total_cost", "label": "Petrol Total Cost", "type": "number", "precision": 0 }, { "key": "ev_running_cost_per_km", "label": "EV Running Cost", "type": "number", "unit": "/km", "precision": 2 }, { "key": "petrol_running_cost_per_km", "label": "Petrol Running Cost", "type": "number", "unit": "/km", "precision": 2 }, { "key": "real_world_range_km", "label": "Real-world Range", "type": "number", "unit": "km", "precision": 0 }, { "key": "estimated_battery_kwh", "label": "Estimated Battery", "type": "number", "unit": "kWh", "precision": 1 }, { "key": "annual_distance_km", "label": "Annual Distance", "type": "integer", "unit": "km" }, { "key": "comparison_table", "label": "Cost Breakdown", "type": "string", "render": "code" }, { "key": "range_note", "label": "Range Note", "type": "string" }, { "key": "assumptions_note", "label": "Assumptions", "type": "string", "render": "lines" } ], "endpoint": "/v1/general-utility/ev-petrol-cost-calculator" }