{"openapi":"3.1.0","info":{"title":"Solar Quote Audit API","version":"1.0.0","description":"Independent second-opinion and quote-clarity API for residential solar proposals in California. Illustrative, educational decision-support only. This is an independent second-opinion and quote-clarity review — not legal, tax, financial, engineering, or contracting advice. It provides illustrative estimates only, does not guarantee savings or system performance, does not make any financial guarantee, does not endorse or certify any installer, and does not take any consequential action on your behalf. Verify all details with qualified professionals before signing anything.","contact":{"name":"The Energy Concierge","email":"Robyn@theenergyconcierge.com"}},"servers":[{"url":"https://solarquoteanalyzer.com"}],"paths":{"/api/v1/analyze-solar-quote":{"post":{"operationId":"analyzeSolarQuote","summary":"Analyze a residential solar proposal for clarity and completeness.","description":"Returns a Quote Clarity Score (0-100), red flags, missing information, questions to ask, and a recommended next step. Illustrative educational decision-support only — no financial guarantees, no guaranteed savings or system performance, and no consequential action.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","description":"Fields extracted from a residential solar proposal. All fields are optional — the tool scores clarity based on what is present and flags what is missing. Provide numbers without currency or percent symbols.","properties":{"cashPrice":{"type":"number","description":"Total cash price for the system in USD."},"financedPrice":{"type":"number","description":"Total financed price in USD, if different from cash."},"systemSizeKw":{"type":"number","description":"System size in kilowatts (kW)."},"panelCount":{"type":"number","description":"Number of solar panels."},"panelModel":{"type":"string","description":"Solar panel brand and model."},"annualProductionEstimate":{"type":"number","description":"Quoted annual production estimate in kWh."},"annualUsageAvailable":{"type":"boolean","description":"True if the installer confirmed sizing against your actual annual kWh usage."},"batteryIncluded":{"type":"boolean","description":"True if a battery is included in the proposal."},"batteryModel":{"type":"string","description":"Battery brand and model."},"batteryCount":{"type":"number","description":"Number of battery units."},"batteryUsableCapacityKwh":{"type":"number","description":"Battery usable capacity in kWh."},"batteryPriceSeparate":{"type":"number","description":"Battery cost as a separate line item in USD."},"roofingCost":{"type":"number","description":"Roofing add-on cost in USD."},"panelUpgradeCost":{"type":"number","description":"Electrical panel upgrade cost in USD."},"otherAddonsCost":{"type":"number","description":"Other itemized add-on costs in USD."},"financeType":{"type":"string","enum":["cash","loan","lease","ppa","prepaid_lease"],"description":"How the system is paid for."},"apr":{"type":"number","description":"Annual percentage rate for financing."},"termYears":{"type":"number","description":"Financing term in years."},"monthlyPayment":{"type":"number","description":"Monthly payment in USD."},"downPayment":{"type":"number","description":"Down payment in USD."},"escalatorPct":{"type":"number","description":"Annual payment escalator percentage (0 if none)."},"totalPayments":{"type":"number","description":"Total of all payments over the term in USD."},"earlyPayoffTermsShown":{"type":"boolean","description":"True if early payoff terms are disclosed."},"buyoutLanguageShown":{"type":"boolean","description":"True if lease/PPA buyout language is present."},"transferLanguageShown":{"type":"boolean","description":"True if contract transfer terms are disclosed."},"installerName":{"type":"string","description":"Installer company name."},"licenseNumber":{"type":"string","description":"Contractor (CSLB) license number."},"installerAddressShown":{"type":"boolean","description":"True if a physical installer address is shown."},"crewType":{"type":"string","enum":["w2","subcontractor","unknown"],"description":"Installation crew model."},"workmanshipWarrantyYears":{"type":"number","description":"Workmanship warranty duration in years."},"roofPenetrationWarranty":{"type":"boolean","description":"True if a roof penetration warranty is stated."},"warrantyRegistrationExplained":{"type":"boolean","description":"True if warranty registration is explained."},"bondInsuranceShown":{"type":"boolean","description":"True if bond/insurance documentation is shown."},"ptoResponsibilityShown":{"type":"boolean","description":"True if PTO/interconnection responsibility is stated."},"installTimelineShown":{"type":"boolean","description":"True if an install timeline is shown."},"cancellationInfoShown":{"type":"boolean","description":"True if cancellation/rescission rights are shown."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Structured second-opinion analysis.","content":{"application/json":{"schema":{"type":"object","properties":{"overall_rating":{"type":"string","example":"Needs Clarification"},"total_clarity_score":{"type":"number","example":62},"scores":{"type":"object","properties":{"price_transparency":{"type":"number"},"financing_contract":{"type":"number"},"system_battery":{"type":"number"},"installer_protection":{"type":"number"}}},"red_flags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"severity":{"type":"string","enum":["high","medium","low"]},"category":{"type":"string"}}}},"missing_information":{"type":"array","items":{"type":"string"}},"questions_to_ask":{"type":"array","items":{"type":"string"}},"recommended_next_step":{"type":"string"},"financial_items_to_confirm":{"type":"array","items":{"type":"string"}},"design_battery_items_to_confirm":{"type":"array","items":{"type":"string"}},"installer_warranty_items_to_verify":{"type":"array","items":{"type":"string"}},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid request body."},"500":{"description":"Analysis failed."}}}}},"components":{"schemas":{"SolarQuoteInputs":{"type":"object","description":"Fields extracted from a residential solar proposal. All fields are optional — the tool scores clarity based on what is present and flags what is missing. Provide numbers without currency or percent symbols.","properties":{"cashPrice":{"type":"number","description":"Total cash price for the system in USD."},"financedPrice":{"type":"number","description":"Total financed price in USD, if different from cash."},"systemSizeKw":{"type":"number","description":"System size in kilowatts (kW)."},"panelCount":{"type":"number","description":"Number of solar panels."},"panelModel":{"type":"string","description":"Solar panel brand and model."},"annualProductionEstimate":{"type":"number","description":"Quoted annual production estimate in kWh."},"annualUsageAvailable":{"type":"boolean","description":"True if the installer confirmed sizing against your actual annual kWh usage."},"batteryIncluded":{"type":"boolean","description":"True if a battery is included in the proposal."},"batteryModel":{"type":"string","description":"Battery brand and model."},"batteryCount":{"type":"number","description":"Number of battery units."},"batteryUsableCapacityKwh":{"type":"number","description":"Battery usable capacity in kWh."},"batteryPriceSeparate":{"type":"number","description":"Battery cost as a separate line item in USD."},"roofingCost":{"type":"number","description":"Roofing add-on cost in USD."},"panelUpgradeCost":{"type":"number","description":"Electrical panel upgrade cost in USD."},"otherAddonsCost":{"type":"number","description":"Other itemized add-on costs in USD."},"financeType":{"type":"string","enum":["cash","loan","lease","ppa","prepaid_lease"],"description":"How the system is paid for."},"apr":{"type":"number","description":"Annual percentage rate for financing."},"termYears":{"type":"number","description":"Financing term in years."},"monthlyPayment":{"type":"number","description":"Monthly payment in USD."},"downPayment":{"type":"number","description":"Down payment in USD."},"escalatorPct":{"type":"number","description":"Annual payment escalator percentage (0 if none)."},"totalPayments":{"type":"number","description":"Total of all payments over the term in USD."},"earlyPayoffTermsShown":{"type":"boolean","description":"True if early payoff terms are disclosed."},"buyoutLanguageShown":{"type":"boolean","description":"True if lease/PPA buyout language is present."},"transferLanguageShown":{"type":"boolean","description":"True if contract transfer terms are disclosed."},"installerName":{"type":"string","description":"Installer company name."},"licenseNumber":{"type":"string","description":"Contractor (CSLB) license number."},"installerAddressShown":{"type":"boolean","description":"True if a physical installer address is shown."},"crewType":{"type":"string","enum":["w2","subcontractor","unknown"],"description":"Installation crew model."},"workmanshipWarrantyYears":{"type":"number","description":"Workmanship warranty duration in years."},"roofPenetrationWarranty":{"type":"boolean","description":"True if a roof penetration warranty is stated."},"warrantyRegistrationExplained":{"type":"boolean","description":"True if warranty registration is explained."},"bondInsuranceShown":{"type":"boolean","description":"True if bond/insurance documentation is shown."},"ptoResponsibilityShown":{"type":"boolean","description":"True if PTO/interconnection responsibility is stated."},"installTimelineShown":{"type":"boolean","description":"True if an install timeline is shown."},"cancellationInfoShown":{"type":"boolean","description":"True if cancellation/rescission rights are shown."}},"additionalProperties":false},"SolarQuoteAnalysis":{"type":"object","properties":{"overall_rating":{"type":"string","example":"Needs Clarification"},"total_clarity_score":{"type":"number","example":62},"scores":{"type":"object","properties":{"price_transparency":{"type":"number"},"financing_contract":{"type":"number"},"system_battery":{"type":"number"},"installer_protection":{"type":"number"}}},"red_flags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"severity":{"type":"string","enum":["high","medium","low"]},"category":{"type":"string"}}}},"missing_information":{"type":"array","items":{"type":"string"}},"questions_to_ask":{"type":"array","items":{"type":"string"}},"recommended_next_step":{"type":"string"},"financial_items_to_confirm":{"type":"array","items":{"type":"string"}},"design_battery_items_to_confirm":{"type":"array","items":{"type":"string"}},"installer_warranty_items_to_verify":{"type":"array","items":{"type":"string"}},"disclaimer":{"type":"string"}}}}},"x-mcp":{"remote":"https://solarquoteanalyzer.com/api/mcp","webmcp":"https://solarquoteanalyzer.com/api/webmcp","discovery":"https://solarquoteanalyzer.com/.well-known/mcp.json"}}