API 01
Address Validation API
Autocomplete and normalize user input addresses for reliable downstream estimation.
POST /v1/address/validate
Available APIs
API 02
Usage Estimator API
Returns estimated monthly consumption profile by validated address.
POST /v1/usage/estimate
API 03
Simulation API
Computes production, self-use, import/export, offset, and economics from system inputs.
POST /v1/simulation/run
API 04
Report Export API
Generates client-ready PDF or XLSX report packages from simulation results.
POST /v1/reports/export
Sample Response Fields
- Energy: annualProductionKwh, annualLoadKwh, offsetPct
- Billing: oldBill, newBill, exportCredit, totalBenefit
- 24h Profile: hour, solarKw, loadKw, socKwh, importKw, exportKw
- Equipment: panelCount, batteryCount, pvDcKw, batteryTotalKwh
Example Payload
{
"addressId": "addr_xxx",
"panels": 21,
"batteries": 8,
"importRate": 0.15,
"exportRate": 0.02,
"financing": { "apr": 8.0, "termYears": 20 }
}
Integration Flow
Step 1
Request API key and sandbox access.
Step 2
Validate addresses and fetch usage profile.
Step 3
Run simulation and capture economics fields.
Step 4
Export branded report to your workflow.
Data Contract Snapshot (AI-Readable)
| Category | Core Fields | Usage |
|---|---|---|
| Address | addressId, formattedAddress, region, postalCode | Lead qualification and geo-normalized intake |
| Energy | annualProductionKwh, annualLoadKwh, offsetPct | Sizing validation and homeowner planning |
| Billing | oldBill, netBill, exportCredit, totalBenefit | Savings communication and financing workflows |
| Hourly Flow | hour, solarKw, loadKw, socKwh, importKw, exportKw | Charting and operational explainability |
Assumptions: flat import/export rate modeling, planning-level estimate scope, and customer-adjustable system inputs.
Last content update: February 23, 2026.
API FAQ
Which teams should start with this API?
Installer sales teams, loan origination teams, and partner platforms that need fast, transparent homeowner estimates.
Can we use API outputs in customer proposals?
Yes. You can convert simulation responses into PDF and XLSX reports for advisor-led or self-serve customer journeys.
Are the results final engineering values?
No. Outputs are planning-level estimates and should be finalized by licensed site assessment and interconnection review.