Key Takeaways
- Enables automated proposal creation from external CRMs, websites, or custom applications
- Accepts inputs like address, roof data, energy consumption, and equipment preferences
- Returns formatted proposals with system designs, production estimates, and financial projections
- Reduces proposal turnaround from hours to seconds for standard residential projects
- Supports white-labeling, custom branding, and multi-language output
- Critical for solar companies scaling beyond 100+ proposals per month
What Is a Proposal API?
A proposal API (Application Programming Interface) is a programmatic interface that allows third-party software applications to generate solar proposals automatically. Instead of a sales rep manually opening a design tool, creating a layout, running simulations, and building a proposal document, an API call triggers the entire process — accepting input parameters and returning a complete, customer-ready proposal.
In practice, this means a solar company’s website can generate instant proposals from a customer’s address and utility bill, a CRM can trigger proposal creation when a lead reaches the “qualified” stage, or a partner platform can embed solar proposals within its own user interface.
A proposal API transforms the sales process from “request a quote and wait 24–48 hours” to “enter your address and see your proposal in 30 seconds.” Companies using API-driven proposals report 3–5x higher lead conversion rates compared to manual quote workflows.
How a Proposal API Works
The API workflow connects external applications to the proposal generation engine:
API Request
The external application sends an HTTP request to the proposal API endpoint with required parameters — typically address, monthly electricity bill, roof characteristics, and equipment preferences.
Data Enrichment
The API enriches the input data with satellite imagery, weather data, utility rate schedules, and available incentives. Missing inputs are filled with intelligent defaults based on location and building type.
Automated Design
The engine generates a panel layout on the roof, applying setback rules, obstruction avoidance, and optimal orientation. String sizing and inverter selection follow equipment compatibility rules.
Energy Simulation
Production estimates are calculated using the generated design, local irradiance data, shading analysis, and equipment specifications. Monthly and annual kWh projections are produced.
Financial Analysis
The API calculates system cost, applicable incentives (ITC, state rebates), financing options (loan, lease, PPA), monthly savings, payback period, and 25-year ROI projections.
Proposal Output
The API returns a complete proposal — either as structured JSON data for custom rendering or as a formatted PDF/HTML document ready for customer delivery. Branding, logos, and color schemes are configurable.
Total Response Time = Data Enrichment + Design + Simulation + Financial Calc (target: under 30 seconds)API Integration Patterns
Proposal APIs can be integrated into various workflows depending on the solar company’s tech stack:
Website Widget Integration
A customer-facing widget on the solar company’s website collects address and bill data, calls the API, and displays an instant proposal. Converts anonymous website visitors into qualified leads with specific system and savings information.
CRM Automation
The API is triggered automatically when a lead reaches a specific pipeline stage in the CRM. Proposals are generated and attached to the lead record without manual intervention, allowing sales reps to focus on customer conversations.
White-Label Embedding
Real estate platforms, home improvement sites, or energy marketplaces embed the proposal API to offer solar estimates under their own branding. The solar company provides the technology; the partner provides the customer traffic.
Custom Sales App
Field sales reps use a custom mobile app that calls the API on-site during door-to-door sales. The rep enters the address, and within seconds has a personalized proposal to present to the homeowner at the doorstep.
API-generated designs are starting points, not final designs. They use automated algorithms that work well for standard roof geometries but may need manual refinement for complex roofs. Use solar design software to validate and adjust API-generated layouts before submitting permit applications.
Key API Parameters and Outputs
Understanding the data flow helps developers and integrators build effective implementations:
| Input Parameter | Type | Description |
|---|---|---|
| Address | String | Property address for satellite imagery and weather data lookup |
| Monthly Bill | Number ($) | Average monthly electricity cost for consumption estimation |
| Roof Segments | Array | Optional — manual roof plane definitions (azimuth, tilt, area) |
| Equipment Preferences | Object | Panel brand/model, inverter type, battery inclusion |
| Financing Type | String | Cash, loan, lease, or PPA — determines financial analysis format |
| Branding | Object | Logo URL, company name, color scheme for proposal output |
| Output Field | Type | Description |
|---|---|---|
| System Design | Object | Panel layout, count, orientation, system size (kW) |
| Production Estimate | Object | Monthly and annual kWh, specific yield, performance ratio |
| Financial Analysis | Object | Total cost, incentives, monthly payment, payback, 25-year savings |
| Proposal Document | URL/Binary | PDF or HTML link to the formatted proposal |
| Design Image | URL | Aerial view with panel overlay for customer presentation |
Conversion Rate = Proposals Viewed / API Calls × Close RatePractical Guidance
Proposal APIs serve different needs depending on your role in the solar company:
- Handle edge cases gracefully. Not every address will have clean satellite imagery or valid utility data. Build fallback logic that returns partial results or requests additional input rather than failing silently.
- Cache expensive operations. Satellite imagery, weather data, and utility rate lookups are slow and expensive. Cache these by location to reduce response times and API costs for repeat requests in the same area.
- Version your API endpoints. As design algorithms and financial models improve, release new versions without breaking existing integrations. Support at least two concurrent API versions during migration periods.
- Implement rate limiting and authentication. Proposal generation is computationally expensive. Use API keys, OAuth, and request quotas to prevent abuse and manage infrastructure costs.
- Validate API proposals before customer delivery. Automated proposals are accurate for standard scenarios but may miscalculate for complex roofs, unusual shading, or non-standard electrical setups. Establish a review workflow for edge cases.
- Use the API for volume, manual tools for accuracy. API proposals are ideal for generating hundreds of preliminary estimates. When a customer is ready to sign, validate the design manually with solar software before finalizing the contract.
- Keep equipment libraries current. API proposals pull from your configured equipment catalog. Update panel models, inverter specs, and pricing regularly to ensure proposals reflect available inventory and current costs.
- Track API-generated vs. manual proposal close rates. Compare conversion rates between instant API proposals and manually crafted proposals. If API proposals close at lower rates, the automated design or financial assumptions may need calibration.
- Use instant proposals to qualify leads faster. Instead of scheduling a site visit for every inquiry, send an automated proposal within minutes. Interested customers self-select by engaging with the proposal — saving your time for serious buyers.
- Personalize the follow-up, not the proposal. Let the API handle the technical proposal generation. Spend your time on personalized follow-up calls that address the customer’s specific questions and concerns about the proposal.
- Embed proposals in your email sequences. Automated email workflows can include a link to the customer’s personalized proposal. “Your solar savings estimate is ready” emails with proposal links get 3–4x higher open rates than generic solar marketing emails.
- Offer multiple scenarios automatically. Configure the API to generate 2–3 system size options (economy, recommended, premium) in a single call. Giving customers choices increases engagement and average deal size.
Generate Proposals at Scale with SurgePV
SurgePV’s proposal platform creates professional, customer-ready proposals with accurate designs and financial analysis — built for solar companies that need speed and accuracy.
Start Free TrialNo credit card required
Real-World Examples
Door-to-Door Sales: Mobile App Integration
A residential solar company equips its 40-person door-to-door team with a custom mobile app powered by a proposal API. Reps enter the homeowner’s address, snap a photo of their utility bill, and receive a branded proposal within 20 seconds. The app generates 300+ proposals per day across the team. Conversion from doorstep presentation to scheduled appointment increased from 8% to 19% compared to the previous “we’ll email you a quote” approach.
Lead Gen Website: Instant Online Estimates
A solar marketing company integrates a proposal API into landing pages for paid search campaigns. Visitors enter their address and average bill to receive an instant savings estimate with a detailed proposal link. The API processes 2,000+ requests per month. Of those, 340 provide contact information to request a follow-up call — a 17% lead capture rate compared to 4% for the previous “fill out a form and wait” approach.
Channel Partner: Real Estate Platform
A home buying platform embeds a solar proposal API into property listing pages. Buyers browsing homes see estimated solar savings alongside mortgage, tax, and insurance data. The API runs automatically when a listing is viewed, using the property address and estimated energy consumption. The solar company receives warm leads from buyers who click “get a detailed solar quote” — leads that already have preliminary savings expectations set by the API estimate.
Technical Considerations
| Factor | Consideration | Best Practice |
|---|---|---|
| Latency | Customers expect sub-30-second results | Pre-compute satellite imagery; cache weather/utility data by ZIP code |
| Accuracy | API designs may not match manual designs | Set expectations — “preliminary estimate” vs. “final proposal” |
| Scalability | Peak traffic can spike 10x during marketing campaigns | Use auto-scaling infrastructure; implement request queuing |
| Data Privacy | Addresses and utility data are PII | Encrypt data in transit and at rest; comply with state privacy laws |
| Cost | Each API call consumes compute, imagery, and weather data | Track cost per proposal; set pricing tiers based on volume |
The highest-performing proposal API integrations include a “refine your estimate” feature that lets the customer adjust assumptions (panel count, financing type, electricity usage) and see the proposal update in real time. This interactive experience increases time-on-page by 3x and doubles lead-to-appointment conversion compared to static PDF proposals.
Frequently Asked Questions
What is a solar proposal API?
A solar proposal API is a programmatic interface that allows software applications to automatically generate solar installation proposals. You send it property and consumption data, and it returns a complete proposal with system design, energy production estimates, financial analysis, and a formatted document — all without manual intervention. Solar companies use proposal APIs to create instant online estimates, automate CRM workflows, and enable partner integrations.
How accurate are API-generated solar proposals?
API-generated proposals are typically within 10–15% of manually designed proposals for standard residential roofs with simple geometries. Accuracy depends on satellite imagery quality, automated shading detection, and the equipment database. For complex roof shapes, significant shading, or unusual installations, API proposals should be treated as preliminary estimates that require manual validation before contract signing.
Can I white-label a proposal API for my solar company?
Yes. Most proposal APIs support white-labeling — you can configure your company logo, brand colors, contact information, and custom messaging. The proposal output looks like it was created by your company, even though the underlying technology is provided by a third-party platform. This is common for both direct installer use and channel partner integrations where multiple brands need distinct proposal branding.
About the Contributors
Co-Founder · SurgePV
Nirav Dhanani is Co-Founder of SurgePV and Chief Marketing Officer at Heaven Green Energy Limited, where he oversees marketing, customer success, and strategic partnerships for a 1+ GW solar portfolio. With 10+ years in commercial solar project development, he has been directly involved in 300+ commercial and industrial installations and led market expansion into five new regions, improving win rates from 18% to 31%.
Content Head · SurgePV
Rainer Neumann is Content Head at SurgePV and a solar PV engineer with 10+ years of experience designing commercial and utility-scale systems across Europe and MENA. He has delivered 500+ installations, tested 15+ solar design software platforms firsthand, and specialises in shading analysis, string sizing, and international electrical code compliance.