How to integrate the power measurements

Upload power

ML forecasting models require training with measured/observed power data, such as power generation for wind or solar sites or power consumption for load sites. To upload the power data use the Upload Site Actuals endpoint. Ensure that all power values are provided in kilowatts [kW] and that each timestamp refers to the start of the corresponding period.

Upload power data

import requests

api_key = "Your API key" # Set your API key
site_id = "a923653c-26f1-1b29-955d-ffde5d182276" # Set the site ID

payload = {
    "data": [
        {
            "valid_time": "2022-05-16T13:00:00Z",
            "value": 140.0 # Average power in kW between 13:00:00Z and 13:15:00Z
        },
        {
            "valid_time": "2022-05-16T13:15:00Z",
            "value": 156.6
        },        
        {
            "valid_time": "2022-05-16T13:30:00Z",
            "value": 220.5
        },
        {
            "valid_time": "2022-05-16T13:45:00Z",
            "value": 310.7
        },
        {
            "valid_time": "2022-05-16T14:00:00Z",
            "value": 324.2
        }
    ]
}

url = f"https://api.rebase.energy/platform/v2/sites/{site_id}/actual"

headers = {
    'Authorization': api_key,
    'Content-Type': 'application/json'
}

response = requests.post(url, json=payload, headers=headers)
response.raise_for_status()
response = response.json()

Response example

{
    "message": "Actuals uploaded successfully"
}

Download power

It is possible to fetch the uploaded power time series from the Rebase Platform using the Get Site Actuals endpoint. The API response contains the power values in kW and their corresponding timestamps. The timestamps are returned in the provided timezone and refer to the start of the corresponding period. If no timezone is provided, the timestamps are returned in UTC. The following paramaters can be specified in the request: Start date start_date
Specify the start date for the time series to fetch. It is a string in ISO 8601 format.
Example: 2024-08-01T00:00:00Z End date end_date
Specify the end date for the time series to fetch. It is a string in ISO 8601 format.
Example: 2024-08-01T04:00:00Z Timezone tz
Specify the timezone for the timestamps. It is a string.
Example: UTC

Download power data

import requests
import pandas as pd

api_key = "Your API key" # Set your API key
site_id = "a923653c-26f1-1b29-955d-ffde5d182276" # Set the site ID 

url = f'https://api.rebase.energy/platform/v2/sites/{site_id}/actual'

headers = {
    'Authorization': api_key,
    'Content-Type': 'application/json'
}

start_date = pd.to_datetime('2024-08-01T00:00').strftime('%Y-%m-%d %H:%M')
end_date = pd.to_datetime('2024-08-01T04:00').strftime('%Y-%m-%d %H:%M')
tz = 'UTC'

params={
	'start_date': start_date,
	'end_date': end_date,
	'tz': tz
}

response = requests.get(url=url, headers=headers, params=params)
response.raise_for_status()
response = response.json()

Response Example

{
    "valid_time": [
        "2024-08-01T00:00:00+0000",
        "2024-08-01T01:00:00+0000",
        "2024-08-01T02:00:00+0000",
        "2024-08-01T03:00:00+0000",
        "2024-08-01T04:00:00+0000"
    ],
    "values": [
        50.6,
        52.9,
        64.7,
        66.6,
        70.2
    ]
}

Delete power

To delete the uploaded power time series from the Rebase Platform use the Delete Site Actuals endpoint. The API response contains a success message. The following paramaters can be specified in the request: Start date start_date
Specify the start date for the time series to delete. It is a string in ISO 8601 format.
Example: 2024-08-01T00:00:00Z End date end_date
Specify the end date for the time series to delete. It is a string in ISO 8601 format.
Example: 2024-08-01T04:00:00Z Timezone tz
Specify the timezone for the timestamps. It is a string.
Example: UTC

Delete power data

import requests
import pandas as pd

api_key = "Your API key" # Set your API key
site_id = "a923653c-26f1-1b29-955d-ffde5d182276" # Set the site ID

url = f'https://api.rebase.energy/platform/v2/sites/{site_id}/actual'

headers = {
    'Authorization': api_key,
    'Content-Type': 'application/json'
}

start_date = pd.to_datetime('2024-08-01T00:00').strftime('%Y-%m-%d %H:%M')
end_date = pd.to_datetime('2024-08-01T04:00').strftime('%Y-%m-%d %H:%M')
tz = 'UTC'

params={
	'start_date': start_date,
	'end_date': end_date,
	'tz': tz
}

response = requests.delete(url=url, headers=headers, params=params)
response.raise_for_status()
response = response.json()

The API response contains a success message.

Response example

{
    "message": "Actuals deleted successfully"
}

Home

Getting started | API

Rebase Dashboard

Upload power

Download power

Delete power

​Upload power

​Download power

​Delete power

Upload power

Download power

Delete power