Get access to real-time and forecasts of Renewable Energy Generation for Germany
Get the Low-Carbon energy periods
Avoid High-Carbon periods for energy-intensive activities
Get 24-hour renewable energy generation forecasts for Germany
Get green and red energy usage time frames for any location worldwide
Click on any endpoint to see detailed information
POST /green
Low-Carbon Energy Periods in Germany
Provides the time frame with the highest amount of renewable energy in the grid (start_green to end_green). Ideal for scheduling activities that consume a lot of energy.
region (required) -
One of the following regions: Amprion, 50Hertz, TenneT, TransnetBW{
"region": "Amprion"
}
{
"message": "Forecast data generated successfully for region: Amprion",
"start_green": "2025-07-16 11:00:00",
"end_green": "2025-07-16 17:00:00"
}
POST /red
High-Carbon Energy Periods in Germany
Identifies time frame with the least amount of renewable energy in the grid (start_red to end_red). Avoid these periods for energy-intensive activities.
region (required) -
One of the following regions: Amprion, 50Hertz, TenneT, TransnetBW{
"region": "Amprion"
}
{
"message": "Forecast data generated successfully for region: Amprion",
"start_red": "2025-07-16 22:00:00",
"end_red": "2025-07-17 01:00:00"
}
POST /forecast
Recommendations and 24-hour forecast for Germany
Provides the optimal times to use electricity and a 24-hour renewable energy generation forecast for Germany.
region (required) -
One of the following regions: Amprion, 50Hertz, TenneT, TransnetBW{
"region": "Amprion"
}
{
"message": "Forecast data generated successfully for region: 50Hertz",
"forecast_result": "To avoid carbon emissions, we recommend using electricity in the following time frame/s: 10:00 to 16:00. We recommend to avoid using electricity in the following time frame/s: 20:00 to 23:00",
"generation_data": [
{
"Wind Generation": 3723.0,
"timestamp": "2025-07-16 01:00:00"
},
{
"Wind Generation": 3647.0,
"timestamp": "2025-07-16 02:00:00"
},
{
"Wind Generation": 3565.75,
"timestamp": "2025-07-16 03:00:00"
}
]
}
POST /carbon-bands
Recommedations for all countries
The API provides time bands showing the green (recommended) and red (not recommended) periods for electricity use in a specific location. It helps schedule energy-intensive tasks when the Carbon-Intensity in the grid is low and avoid energy use when the Carbon-Intensity is high.
lat (required) - Latitude coordinatelng (required) - Longitude coordinatecountryCode (required) - ISO country code (e.g., "DE", "US", "FR")
{
"lat": "52.05501097848496",
"lng": "-70.13671875000001"
}
{
"country": "DE"
}
{
"message": "Carbon bands generated successfully",
"greenBands": [
{
"start": "2025-09-29T05:00:00.000Z",
"end": "2025-09-29T09:00:00.000Z"
},
{
"start": "2025-09-30T23:00:00.000Z",
"end": "2025-10-01T01:00:00.000Z"
}
],
"redBands": [
{
"start": "2025-09-29T16:00:00.000Z",
"end": "2025-09-29T19:00:00.000Z"
}
]
}
Provide your details below to receive a free API key
API Key Security
Include your API key in the Authorization header as "Bearer <your-key>" for all requests.