Solariance API Documentation

Introduction

The Solariance API offers comprehensive access to solar power forecasts and management features for users and photovoltaic (PV) systems. It is REST-compliant and designed for easy integration, supporting both individual and commercial solar applications. High-resolution coverage is available for:

Germany, Austria, Denmark, The Netherlands, Belgium, Luxembourg, Switzerland, Czech Republic

Eastern France, Western Poland, Northern Italy (additional high-res areas)

Rest of Europe (lower resolution)

Live-Demo: https://www.solariance.de/demo

License Agreement

By using Solariance API V1, you agree to:

1. Attribution

You must provide clear attribution in any derivative works, e.g.:

"Powered by Solariance"

"Data provided by Solariance API V1"

2. Non-Commercial Use

Free, Plus, and Premium plans are for non-commercial purposes only.

3. Commercial Use

Premium for Business: Only for internal/own consumption.

Enterprise: Required for integration into products/services or any revenue-generating use.

Contact sales@solariance.de for commercial licensing.

Support

Check Status Page for outages.

Report bugs: GitHub Issues

Email: support@solariance.de

Community

Join the Solariance Community: community.solariance.de

Announcements

General Discussion

Ideas/Feature Requests

Polls

Present Your Projects

Q&A

API Base URL

All API requests:
https://api.solariance.de

Getting Started

1. Create User

Endpoint:
POST /user/create

Request Body Example:

{
    "username": "jon_doe",
    "email": "example@example.com",
    "password": "S3cuR3P@ss!",
    "passwordConfirm": "S3cuR3P@ss!",
    "firstname": "Jon",
    "lastname": "Doe",
    "country": "Germany",
    "company": "Jon Doe & Sons Inc.",
    "acquisition": "Recommendation",
    "newsletter": false,
    "termsAccepted": true
}

Password Requirements:

Minimum 10 characters

At least 1 uppercase letter, 1 number, 1 special character

Verify your email within 48 hours to activate your account.

2. Get API Token

To create an API token, log in to your account at https://www.solariance.de/user and generate a new token from your user dashboard.

Include the token in the Authorization: Bearer eyxxx header for all subsequent requests.

3. Create a New PV System

Endpoint:
POST /system/create

Headers:
Authorization: Bearer eyxxxx

See more detailied documentation about the required payload here

Simple Model Example

{
    "name": "My Simple PV",
    "street": "Egerlandstraße",
    "house": "7",
    "postal_code": "91058",
    "city": "Erlangen",
    "country": "Germany",
    "year": 2022,
    "kWp": 9.0,
    "latitude": 49.57,
    "longitude": 11.02,
    "modules": [],
    "inverter": {}
}

Advanced Model Example

{
    "name": "My Advancded PV",
    "street": "Egerlandstraße",
    "house": "7",
    "postal_code": "91058",
    "city": "Erlangen",
    "latitude": 49.57,
    "longitude": 11.02,
    "country": "Germany",
    "year": 2022,
    "kWp": 9.0,
    "electricity_price": 0.3,
    "feed_in_tariff": 0.1,
    "modules": [
        {
            "name": "Test Modul 380W",
            "quantity": 10,
            "azimuth": 90,
            "tilt": 35,
            "surface_type": "urban",
            "string_name": "East Roof",
            "custom_details": {
                "pdc0": 380,
                "gamma_pdc": -0.004,
                "bifacial": true
            }
        },
        {
            "name": "Test Modul 300W",
            "quantity": 8,
            "azimuth": 180,
            "tilt": 25,
            "surface_type": "grass",
            "string_name": "Garage Roof",
            "custom_details": {
                "pdc0": 300,
                "gamma_pdc": -0.004,
                "bifacial": true
            }
        }
    ],
    "inverter": {
        "name": "Test Inverter",
        "pdc0": 16500,
        "eta_inv_nom": 0.9835
    },
    "correction_factors": []

}

4. Fetch Power Forecast

Endpoint:
GET /forecast/power?system_id=PVXXXX&day=0,1

Headers:
Authorization: Bearer eyxxxx

Example Response:

{
    "code": 200,
    "message": "Power forecasts for system PVXXXX",
    "data": {
        "system_id": "PVXXXX",
        "time_zone": "Europe/Berlin",
        "forecast": [
            [
                {
                    "local_time": "2024-08-21T10:00:00",
                    "step": 15,
                    "ac_output_of_system": 4176.16,
                    "energy_in_time_interval": 1.04,
                    "energy_aggregated_sum_intraday": 6.4
                }
            ]
        ]
    }
}

5. (Optional) Improve Forecast with ML Optimizer

Endpoint:
POST /forecast/optimizer?system_id=PVXXXX&start_date=YEAR-MONTH-DAY&end_date=YEAR-MONTH-DAY&time_zone=UTC

You can improve forecast accuracy using the ML-based Forecast Optimizer endpoint, available for the first time 14 days after system creation.
Endpoint: POST /forecast/optimizer
Scientific studies have shown that such machine learning correction approaches can reduce forecast errors by up to 80% and achieve forecasting accuracies of up to 90% when applied to systematic bias such as local shading.

Detailed documentation: https://developer.solariance.de/api-19684615

GitHub Examples

See Solariance API V1 Python Example for:

Sample Python scripts

Step-by-step guide

Error handling examples

Getting Started

Solariance API Documentation#

Introduction#

License Agreement#

1. Attribution#

2. Non-Commercial Use#

3. Commercial Use#

Support#

Community#

API Base URL#

Getting Started#

1. Create User#

2. Get API Token#

3. Create a New PV System#

Simple Model Example#

Advanced Model Example#

4. Fetch Power Forecast#

5. (Optional) Improve Forecast with ML Optimizer#

GitHub Examples#

Solariance API Documentation

Introduction

License Agreement

1. Attribution

2. Non-Commercial Use

3. Commercial Use

Support

Community

API Base URL

Getting Started

1. Create User

2. Get API Token

3. Create a New PV System

Simple Model Example

Advanced Model Example

4. Fetch Power Forecast

5. (Optional) Improve Forecast with ML Optimizer

GitHub Examples