{"openapi":"3.1.0","info":{"title":"BHIMASEN Energy Solar Estimate API","version":"2026-09-01.1","description":"Public, indicative rooftop-solar sizing, roof-capacity, subsidy, cost and payback estimates for Hyderabad homeowners. Telangana savings use TGERC FY 2026-27 LT-I domestic categories and slabs by default."},"servers":[{"url":"https://bhimasen.com"}],"paths":{"/api/v1/solar/estimate":{"get":{"summary":"Estimate from query parameters","operationId":"getSolarEstimate","parameters":[{"name":"monthlyUnits","in":"query","schema":{"type":"number","minimum":30,"maximum":2500}},{"name":"monthlyBill","in":"query","schema":{"type":"number","minimum":300,"maximum":50000}},{"name":"tariffPerUnit","in":"query","description":"Optional custom effective rate. Omit to use Telangana LT-I domestic slabs.","schema":{"type":"number","minimum":1,"maximum":30}},{"name":"systemSizeKw","in":"query","schema":{"type":"number","minimum":0.5,"maximum":10}},{"name":"usableRoofAreaSqFt","in":"query","description":"Mostly unshaded terrace area after excluding tanks, stair rooms, lift rooms, shaded patches and access paths.","schema":{"type":"number","minimum":90,"maximum":5000}},{"name":"hasGruhaJyothi","in":"query","description":"Whether the household currently receives the eligible Gruha Jyothi zero-bill benefit.","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Indicative solar estimate"},"400":{"description":"Missing or invalid input"}}},"post":{"summary":"Estimate from a JSON request","operationId":"createSolarEstimate","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"monthlyUnits":{"type":"number"},"monthlyBill":{"type":"number"},"tariffPerUnit":{"type":"number","description":"Optional custom rate override."},"systemSizeKw":{"type":"number","description":"Optional homeowner override in 0.5 kW steps."},"usableRoofAreaSqFt":{"type":"number","description":"Mostly unshaded usable terrace area.","minimum":90,"maximum":5000},"hasGruhaJyothi":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Indicative solar estimate"},"400":{"description":"Invalid input"}}}}}}