Skip to main content
POST
/
load-forecasts
Transmit a load forecast
curl --request POST \
  --url https://api.nomos.energy/load-forecasts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scope": "subscription",
  "subscription": "sub_123456789",
  "resolution": "15min",
  "unit": "KW",
  "data": [
    {
      "start": "2025-03-31T22:00:00.000Z",
      "value": 0.2
    },
    {
      "start": "2025-03-31T22:15:00.000Z",
      "value": 0.22
    }
  ]
}
'
{
  "scope": "subscription",
  "subscription": "<string>",
  "start": "2023-11-07T05:31:56Z",
  "end": "2023-11-07T05:31:56Z",
  "total": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Load forecast input

​
scope
enum<string>
required

Reference point for the load forecast

Available options:
subscription
Example:

"subscription"

​
subscription
string
required

Required subscription ID when scope is 'subscription'

Example:

"sub_123456789"

​
resolution
enum<string>
required

Time resolution of the load forecast data points

Available options:
15min
Example:

"15min"

​
unit
enum<string>
required

Unit of measurement for the forecast values

Available options:
KW
Example:

"KW"

​
data
object[]
required

Array of load forecast data points. Must be strictly consecutive with exactly 15-minute intervals and without overlaps or gaps and can only contain one data point per 15-minute interval.

Example:
[
  {
    "start": "2025-03-31T22:00:00.000Z",
    "value": 0.2
  },
  {
    "start": "2025-03-31T22:15:00.000Z",
    "value": 0.22
  }
]

Response

Positive response

​
scope
enum<string>
required
Available options:
subscription
​
subscription
string
required
​
start
string<date-time>
required
​
end
string<date-time>
required
​
total
number
required