Rooftop Solar Suitability API
The problem every solar professional faces ────────────────────────────────────────── Every solar screening tool on the market requires you to manually enter roof area. That means someone has to measure it — from a site visit, a drone, or a satellite service. For a portfolio of 50 buildings, that is 50 manual measurements before you can run a single analysis. This API eliminates that step…
Rooftop Solar Suitability API endpoints
| Method | Endpoint | Description |
|---|---|---|
| health | ||
| GET |
Health Check /health |
Returns server status and the complete list of data sources powering the calculation engine. Call this first if you are troubleshooting a connection issue. No authentication… |
| ping | ||
| GET |
ping_ping_get /ping |
Internal keepalive endpoint. Bypasses proxy secret. Returns minimal payload. |
| pricing | ||
| GET |
Pricing Plans /pricing |
Returns the full plan structure, rate limits, and endpoint access by tier. No authentication required. |
| rooftop | ||
| POST |
Full Financial Analysis /rooftop/full |
PRO PLAN Everything in Quick Site Analysis plus 25-year NPV, IRR, LCOE, demand charge savings, self-sufficiency analysis, and optional BESS recommendation — all in one call.… |
| POST |
Quick Site Analysis /rooftop/quick |
FREE PLAN Send a latitude, longitude, and US state code. The API finds the building in OpenStreetMap, measures the polygon area, and runs a full solar suitability analysis.… |
| POST |
Portfolio Batch Analysis /rooftop/batch |
PRO PLAN Analyse up to 20 sites in a single call. Each site uses the same inputs as POST /rooftop/quick. Results are returned sorted by suitability score — highest first. Request… |
| reference | ||
| GET |
Methodology and Citations /reference/methodology |
Returns the complete 7-step methodology documentation — building detection, area calculation, usable area, panel layout, yield calculation, financial model, and BESS sizing —… |
| GET |
Climate Zones /reference/climate-zones |
Returns all six climate zones with annual specific yield in kWh/kWp/yr and the NREL PVWatts V8 source citation. Includes example US cities for each zone. No authentication… |
| GET |
Building Types /reference/building-types |
Returns all supported building types with their usable roof fractions and the Gagnon et al. (2016) NREL source citation. Use these IDs in the building_type field of any analysis… |
| Other endpoints | ||
| GET |
API Info / |
Returns API version, tagline, and a directory of all endpoints with one-line descriptions. Useful for confirming the correct API is connected. |
Rooftop Solar Suitability API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $49 / month | — |
|