Introduction

Welcome to Rebase Forecast API!

This documentation will show you how to create sites, upload production data, upload localized weather measurements and access forecasts for your sites.

Authentication

How to include API key in your requests

import requests
# this is just an example request showing how to include the API key
url = 'https://api.rebase.energy/platform/v1/<endpoint>'
headers = {
  'GL-API-KEY': your_api_key
}
response = requests.get(url, headers=headers)

const request = require('request');

// this is just an example request showing how to include the API key
const options = {
  url: 'https://api.rebase.energy/platform/v1/<endpoint>',
  headers: {
    'GL-API-KEY': your_api_key
  }
};

request(options);

Make sure to replace your_api_key with your API key.

Each request to the Platform API must be authenticated with an API key. You can create a new API key in your user profile .

The API key must be included in the header for every request like this:

GL-API-KEY: your_api_key

You must replace your_api_key with your personal API key.

Base url

All endpoints in this documentation are relative to this base url:

https://api.rebase.energy/platform/v1

For instance, requesting endpoint /site/forecast/latest/<site_id> should be done to the complete url:

https://api.rebase.energy/platform/v1/site/forecast/latest/<site_id>

Endpoints

Site

Get sites

import requests

url = 'https://api.rebase.energy/platform/v1/sites'

headers = {
  'GL-API-KEY': your_api_key
}

response = requests.get(url, headers=headers)

result = response.json()

const request = require('request');

const options = {
  url: 'https://api.rebase.energy/platform/v1/sites',
  headers: {
    'GL-API-KEY': your_api_key
  }
};

request(options, (error, response, body) => {
    if (response.statusCode === 200){
      // do something with data in body
    }
})

The request above returns JSON structured like this:

[
  {
    "site_id": "c7c6c33c-f873-43e5-9012-da12de68b475",
    "type": "solar",
    "name": "my_site_1",
    "latitude": 55.35,
    "longitude": 12.13,
    "tilt": 10.0,
    "azimuth": 172.9,
    "capacity": [
        {"value": 723.3, "dateEnd": null}
    ]
  }
  {
    "site_id": "bbaff2b9-7818-4abb-997e-60760cb3160e",
    "type": "solar",
    "name": "my_site_2",
    "latitude": 55.33,
    "longitude": 12.12,
    "tilt": 11.1,
    "azimuth": 175.0,
    "capacity": [
        {"value": 600.0, "dateEnd": null}
    ]
  }
]

This endpoint retrieves a list of all your sites.

The site ids returned from this endpoint should be used to query other endpoints which require <site_id>.

HTTP Request

GET /sites

Query Parameters

None

Response

JSON array containing one JSON object per site. Each JSON object has the following attributes:

Attribute	Description
site_id	The id of the site which can be used to request other endpoints. (string)
name	The name of the site. (string)
type	Type of site: solar / wind / localized. (string)
latitude	The latitude value of the site's geographical position. (float)
longitude	The longitude value of the site's geographical position. (float)

Solar sites have the following additional attributes:

Attribute	Description
azimuth	Orientation of solar panels in degrees. N = 0, E = 90, S = 180, W = 270. (float)
tilt	Tilt of solar panels in degrees. 0 to 90. (float)
capacity	Capacity of the site in kW. dateEnd is the date when the capacity value is no longer valid, null means that the value is currently valid. (JSON array)

Wind sites have the following additional attributes:

Attribute	Description
capacity	Capacity of the site in kW. dateEnd is the date when the capacity value is no longer valid, null means that the value is currently valid. (JSON array)
turbines	The wind turbines used by the site (JSON array)

Localized weather sites have the following additional attributes:

Attribute	Description
measurements	The measurement types for the site (JSON array)

Status codes

Code	Meaning
200	Ok
401	Unauthorized -- Your API key is wrong.
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily not able to handle your request. Try again later.

Create solar site

import requests
import json

url = 'https://api.rebase.energy/platform/v1/site/create'

headers = {
  'GL-API-KEY': your_api_key,
  'Content-Type': 'application/json'
}

data = {
  'type': 'solar',
  'name': 'My solar site',
  'latitude': 53.41,
  'longitude': 5.94,
  'azimuth': 171.3, # 0 = North, 90 = East, 180 = South, 270 = West
  'tilt': 10.3,
  'capacity': [
    {'value': 750.5, 'validFrom': '2019-10-10T00:00:00Z'}, # capacity of site changed to 750.5 kW at this date
    {'value': 500.3, 'validFrom': '2019-04-03T00:00:00Z'}, # site was installed at this date
  ],
}

response = requests.post(url, headers=headers, data=json.dumps(data))

data = response.json()

const request = require('request');

const data = {
  type: 'solar',
  name: 'My solar site',
  latitude: 53.41,
  longitude: 5.94,
  azimuth: 171.3, // 0 = North, 90 = East, 180 = South, 270 = West
  tilt: 10.3,
  capacity: [
    {value: 750.5, validFrom: '2019-10-10T00:00:00Z'}, // capacity of site changed to 750.5 kW at this date
    {value: 500.3, validFrom: '2019-04-03T00:00:00Z'}, // site was installed at this date
  ],
};

const options = {
  url: 'https://api.rebase.energy/platform/v1/site/create',
  headers: {
    'GL-API-KEY': your_api_key,
    'Content-Type': 'application/json'
  },
  json: data
};

request.post(options, (error, response, body) => {
    if (response.statusCode === 200){
      // do something with data in body
    }
})

The request above returns JSON structured like this:

{
  "site_id": "04a24f77-60a0-41da-a844-ec0d7b6b904f"
}

Create a new solar site.

HTTP Request

GET /site/create

Query Parameters

None

Body

The body of the POST request must be a JSON object containing the following:

Attribute	Description
type	solar
name	Name to give to site
latitude	latitude of site (29.5 to 70.5)
longitude	longitude of site (-23.5 to 45)
azimuth	orientation of solar panels (0 N, 90 E, 180 S, 270 W) degrees
tilt	tilt of solar panels (0 to 90) degrees
capacity	Capacity of site - array of JSON objects. Each JSON object should contain the capacity value in kW and the date (ISO 8601) from which the value is valid from.

Response

JSON object containing site_id of the created site

Attribute	Description
site_id	id of the created site

Status codes

Code	Meaning
200	Ok
400	Bad request -- POST data is missing or incorrectly formatted.
401	Unauthorized -- Your API key is wrong.
404	Not Found -- The site does not exist.
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily not able to handle your request. Try again later.

Create wind site

import requests
import json

url = 'https://api.rebase.energy/platform/v1/site/create'

headers = {
  'GL-API-KEY': your_api_key,
  'Content-Type': 'application/json'
}

data = {
  'type': 'wind',
  'name': 'My wind site',
  'latitude': 53.41,
  'longitude': 5.94,
  'capacity': [
    {'value': 4000, 'validFrom': '2019-10-10T00:00:00Z'}, # capacity of site changed to 750.5 kW at this date
    {'value': 2000, 'validFrom': '2019-04-03T00:00:00Z'}, # site was installed at this date
  ],
}

response = requests.post(url, headers=headers, data=json.dumps(data))

data = response.json()

const request = require('request');

const data = {
  type: 'wind',
  name: 'My wind site',
  latitude: 53.41,
  longitude: 5.94,
  capacity: [
    {value: 4000, validFrom: '2019-10-10T00:00:00Z'}, # capacity of site changed to 750.5 kW at this date
    {value: 2000, validFrom: '2019-04-03T00:00:00Z'}, # site was installed at this date
  ],
};

const options = {
  url: 'https://api.rebase.energy/platform/v1/site/create',
  headers: {
    'GL-API-KEY': your_api_key,
    'Content-Type': 'application/json'
  },
  json: data
};

request.post(options, (error, response, body) => {
    if (response.statusCode === 200){
      // do something with data in body
    }
})

The request above returns JSON structured like this:

{
  "site_id": "04a24f77-60a0-41da-a844-ec0d7b6b904f"
}

Create a new wind site.

HTTP Request

GET /site/create

Query Parameters

None

Body

The body of the POST request must be a JSON object containing the following:

Attribute	Description
type	wind
name	Name to give to site
latitude	latitude of site (29.5 to 70.5)
longitude	longitude of site (-23.5 to 45)
capacity	Capacity of site - array of JSON objects. Each JSON object should contain the capacity value in kW and the date (ISO 8601) from which the value is valid from.

Response

JSON object containing site_id of the created site

Attribute	Description
site_id	id of the created site

Status codes

Code	Meaning
200	Ok
400	Bad request -- POST data is missing or incorrectly formatted.
401	Unauthorized -- Your API key is wrong.
404	Not Found -- The site does not exist.
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily not able to handle your request. Try again later.

Create localized weather site

import requests
import json

url = 'https://api.rebase.energy/platform/v1/site/create'

headers = {
  'GL-API-KEY': your_api_key,
  'Content-Type': 'application/json'
}

data = {
  'type': 'localized',
  'name': 'My localized site',
  'latitude': 53.41,
  'longitude': 5.94,
  'measurement': 'WindSpeed'
}

response = requests.post(url, headers=headers, data=json.dumps(data))

data = response.json()

const request = require('request');

const data = {
  type: 'localized',
  name: 'My localized site',
  latitude: 53.41,
  longitude: 5.94,
  measurement: 'WindSpeed'
};

const options = {
  url: 'https://api.rebase.energy/platform/v1/site/create',
  headers: {
    'GL-API-KEY': your_api_key,
    'Content-Type': 'application/json'
  },
  json: data
};

request.post(options, (error, response, body) => {
    if (response.statusCode === 200){
      // do something with data in body
    }
})

The request above returns JSON structured like this:

{
  "site_id": "04a24f77-60a0-41da-a844-ec0d7b6b904f"
}

Create a new localized weather site.

Only supports AI forecasts. First create a site as described below with one of the following supported measurement types:

measurement	unit
WindSpeed	m/s
Temperature	°C
CloudCover	%

Then to create the AI forecast, upload data for the same measurement type as described in Upload data & train model > Measurement

HTTP Request

GET /site/create

Query Parameters

None

Body

The body of the POST request must be a JSON object containing the following:

Attribute	Description
type	localized
name	Name to give to site
latitude	latitude of site (29.5 to 70.5)
longitude	longitude of site (-23.5 to 45)
measurement	WindSpeed / Temperature / CloudCover

Response

JSON object containing site_id of the created site

Attribute	Description
site_id	id of the created site

Status codes

Code	Meaning
200	Ok
400	Bad request -- POST data is missing or incorrectly formatted.
401	Unauthorized -- Your API key is wrong.
404	Not Found -- The site does not exist.
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily not able to handle your request. Try again later.

Create load site

import requests
import json

url = 'https://api.rebase.energy/platform/v1/site/create'

headers = {
  'GL-API-KEY': your_api_key,
  'Content-Type': 'application/json'
}

data = {
  'type': 'load',
  'name': 'My load site',
  'latitude': 53.41,
  'longitude': 5.94,
  'nwps': ['DWD_ICON-EU', 'NCEP_GFS'],
  'variables': [
      {'name': 'Temperature', 'lag': [-4, -3, -2, -1, 1, 2, 3, 4]},
      {'name': 'SolarDownwardRadiation'},
  ],
  'calendar': ['holidays', 'hourOfDay'],
}

response = requests.post(url, headers=headers, data=json.dumps(data))

data = response.json()

const request = require('request');

const data = {
  type: 'load',
  name: 'My load site',
  latitude: 53.41,
  longitude: 5.94,
  nwps: ['DWD_ICON-EU', 'NCEP_GFS'],
  variables: [
      {name: 'Temperature', lag: [-4, -3, -2, -1, 1, 2, 3, 4]},
      {name: 'SolarDownwardRadiation'},
  ],
  calendar: ['holidays', 'hourOfDay'],
};

const options = {
  url: 'https://api.rebase.energy/platform/v1/site/create',
  headers: {
    'GL-API-KEY': your_api_key,
    'Content-Type': 'application/json'
  },
  json: data
};

request.post(options, (error, response, body) => {
    if (response.statusCode === 200){
      // do something with data in body
    }
})

The request above returns JSON structured like this:

{
  "site_id": "04a24f77-60a0-41da-a844-ec0d7b6b904f"
}

Create a new load site.

Only supports AI forecasts. First create a site as described below. Then to create the AI forecast, upload data to train as described in Upload data & train model > Measurement

HTTP Request

GET /site/create

Query Parameters

None

Body

The body of the POST request must be a JSON object containing the following:

Attribute	Description
type	load
name	Name to give to site
latitude	latitude of site (29.5 to 70.5)
longitude	longitude of site (-23.5 to 45)
nwps	array of one or more NWPS to train. Available NWPS: DWD_ICON-EU NCEP_GFS Example: ['DWD_ICON-EU', 'NCEP_GFS']
variables	array of JSON objects, containing NWP variables and lags. Available variables: Temperature SolarDownwardRadiation WindSpeed WindDirection CloudCover Each variable can have an optional array of lags with values in range -24 to 24 Example: [ {'name': 'Temperature', 'lag': [-4, -3, -2, -1, 1, 2, 3, 4]}, {'name': 'SolarDownwardRadiation'} ]
calendar	array of calendar features that should be included in model training. Available features: holidays - If the model should take public holidays into account hourOfDay - If the model should take into account which hour of the day it is dayOfWeek - If the model should take into account which day of the week it is weekOfYear - If the model should take into account which week of the year it is Example: ['holidays', 'hourOfDay']

Response

JSON object containing site_id of the created site

Attribute	Description
site_id	id of the created site

Status codes

Code	Meaning
200	Ok
400	Bad request -- POST data is missing or incorrectly formatted.
401	Unauthorized -- Your API key is wrong.
404	Not Found -- The site does not exist.
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily not able to handle your request. Try again later.

Forecast

Latest forecast

import requests

# replace <site_id> here with an actual id for a site
url = 'https://api.rebase.energy/platform/v1/site/forecast/latest/<site_id>'

headers = {
  'GL-API-KEY': your_api_key
}

params = {
  'type': 'ai',
  'additional': "['clearsky']"
}

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

result = response.json()

const request = require('request');

const options = {
  // replace <site_id> here with an actual id for a site
  url: 'https://api.rebase.energy/platform/v1/site/forecast/latest/<site_id>',
  headers: {
    'GL-API-KEY': your_api_key
  }
};

request(options, (error, response, body) => {
    if (response.statusCode === 200){
      // do something with data in body
    }
})

The above command returns JSON structured like this:

{
  "ref_time": "2020-01-05T00:00Z",
  "valid_time": [
      "2020-01-05T00:00Z",
      "2020-01-05T00:15Z",
      "2020-01-05T00:30Z",
      "2020-01-05T00:45Z",
      "2020-01-05T01:00Z",
      ...,
      "2020-01-10T00:00Z"
  ],
  "forecast": [
      634.5,
      637.1,
      711.9,
      729.6,
      800.5,
      ...,
      958.3
  ],
  "type": "ai",
  "additional": {
    "clearsky": {
      "forecast": [...],
      "valid_time": [...]
    }
  }
}

This endpoint retrieves the latest forecast for a specified site.

To get an AI forecast you must first have uploaded power production data and trained a model. See Upload data & train model > Measurement

HTTP Request

GET /site/forecast/latest/<site_id>

Query Parameters

Parameter	Required	Values	Default	Description
type	No	prioritized, ai, physical	prioritized	Type of forecast to return. 'prioritized' returns the best forecast at the time
normalize	No	True, False	False	If set to True, will return forecast normalized by site capacity. This is only available for capacity limited sites.
additional	No	['clearsky']	None	A string representing a list of strings of additional forecast data to return. Clearsky option is only available for solar sites.

Response

JSON object containing two arrays of equal length, one with valid times and the other with forecast values.

Attribute	Description
ref_time	Reference time the forecast was calculated for.
valid_time	Array of timestamps which the forecast values are valid for (UTC timezone). (array of ISO 8601 formatted strings)
forecast	Array of forecast values in kilowatts (kW). (array of floats)
type	Type of forecast. Same as query parameter.
additional	JSON object containing additional forecast data. Contains clear sky forecast for solar sites if 'clearsky' supplied in additional query parameter.

Status codes

Code	Meaning
200	Ok
401	Unauthorized -- Your API key is wrong.
404	Not Found -- The site does not exist.
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily not able to handle your request. Try again later.

Upload data & train model

Measurement

import requests
import json

# replace <site_id> here with an actual id for a site
url = 'https://api.rebase.energy/platform/v1/site/measurement/upload/<site_id>'

headers = {
  'GL-API-KEY': your_api_key,
  'Content-Type': 'application/json'
}

data = {
  'valid_time': [
    '2020-01-01T00:00:00Z',
    '2020-01-01T00:10:00Z',
    '2020-01-01T00:20:00Z',
    '2020-01-01T00:30:00Z',
    '2020-01-01T00:40:00Z'
  ],
  'measurement': [
    5.6,
    5.9,
    6.7,
    6.6,
    7.2,
    6.8
  ],
  'type': '<measurement type>'
}

response = requests.post(url, headers=headers, data=json.dumps(data))

const request = require('request');

const data = {
  valid_time: [
    '2020-01-01T00:00:00Z',
    '2020-01-01T00:10:00Z',
    '2020-01-01T00:20:00Z',
    '2020-01-01T00:30:00Z',
    '2020-01-01T00:40:00Z'
  ],
  measurement: [
    5.6,
    5.9,
    6.7,
    6.6,
    7.2,
    6.8
  ],
  type: '<measurement type>'
}

const options = {
  // replace <site_id> here with an actual id for a site
  url: 'https://api.rebase.energy/platform/v1/site/localized/measurement/upload/<site_id>',
  headers: {
    'GL-API-KEY': your_api_key,
    'Content-Type': 'application/json'
  },
  json: data
};


request.post(options);

This endpoints uploads measurements for a specific site. Once successfully uploaded, AI models will be trained on the new data. New AI forecasts should become available a few minutes later.

HTTP Request

GET /site/localized/measurement/upload/<site_id>

Query Parameters

None

Body

The body in the POST data must be a JSON object containing the following:

Attribute	Value
valid_time	Array of timestamps (ISO 8601 formatted) [t1, t2, ..., tn]
measurement	Array of measurement values [v1, v2, ..., vn]
type	Type of measurement. This type must match the measurement type the site was created with. Available measurements: ProductionPower - in [kW] EnergyConsumption - in [kW] WindSpeed - in [m/s] Temperature - in [°C] CloudCover - in [%]

Response

'Ok', confirmation message that data was successfully uploaded

Status codes

Code	Meaning
200	Ok
400	Bad request -- POST data is missing or incorrectly formatted.
401	Unauthorized -- Your API key is wrong.
404	Not Found -- The site does not exist.
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily not able to handle your request. Try again later.