English
Introduction to the V2 API
The pvnode V2 API is the next generation of our solar API. It delivers precise PV power forecasts and historical yield data via a REST interface — now built around stored sites instead of long URL parameter chains.
What's new compared to V1?
In V1, every request was configured entirely through URL parameters
(/v1/forecast?latitude=…&longitude=…&slope=…). In V2 you create a site once
and then query it solely through its site_id:
V2 Forecast API
This brings several advantages:
- Fixed sites with a simple, short query — no need to repeat the configuration.
- Multiple PV strings per site (different orientation/tilt) in a single model.
includegroups instead of freely mixedrequired_datalists.
The V1 API remains unchanged and still available. Existing integrations keep working. The migration guide describes how to switch over.
The three building blocks
| Building block | Purpose |
|---|---|
| Sites | Create and configure PV systems (geometry, strings, module technology, shading, trackers). |
| Forecasts | PV power forecast for a site, optionally with weather, irradiance, variability band. |
| Historical data | Past PV yields and weather data over freely selectable time ranges. |
Hobby vs. Pro
- Hobby users manage their sites through the pvnode web app and query forecasts via the API.
- Pro/B2B users additionally manage sites programmatically via the API and can use the inline endpoints — see Enterprise.
Next steps
- Quickstart — from API key to your first forecast in minutes.
- Sites & Solar Areas — understand the data model.
- API Reference — complete endpoint, parameter and field list.
Last modified on