Post Pv Control Schedule
curl --request POST \
--url https://api.nox.energy/v1/devices/pv/schedules \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
[
{
"device_id": "PV1",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "export_curtailment"
}
]
},
{
"device_id": "PV2",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "production_curtailment"
}
]
},
{
"device_id": "PV3",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"control_type": "default"
}
]
},
{
"device_id": "PV4",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "export_curtailment"
},
{
"start_time": "2025-08-05T10:21:00Z",
"end_time": "2025-08-05T10:25:00Z",
"control_type": "production_curtailment"
}
]
}
]
'import requests
url = "https://api.nox.energy/v1/devices/pv/schedules"
payload = [
{
"device_id": "PV1",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "export_curtailment"
}
]
},
{
"device_id": "PV2",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "production_curtailment"
}
]
},
{
"device_id": "PV3",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"control_type": "default"
}
]
},
{
"device_id": "PV4",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "export_curtailment"
},
{
"start_time": "2025-08-05T10:21:00Z",
"end_time": "2025-08-05T10:25:00Z",
"control_type": "production_curtailment"
}
]
}
]
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
device_id: 'PV1',
schedules: [
{
start_time: '2025-08-05T10:15:00Z',
end_time: '2025-08-05T10:20:00Z',
control_type: 'export_curtailment'
}
]
},
{
device_id: 'PV2',
schedules: [
{
start_time: '2025-08-05T10:15:00Z',
end_time: '2025-08-05T10:20:00Z',
control_type: 'production_curtailment'
}
]
},
{
device_id: 'PV3',
schedules: [{start_time: '2025-08-05T10:15:00Z', control_type: 'default'}]
},
{
device_id: 'PV4',
schedules: [
{
start_time: '2025-08-05T10:15:00Z',
end_time: '2025-08-05T10:20:00Z',
control_type: 'export_curtailment'
},
{
start_time: '2025-08-05T10:21:00Z',
end_time: '2025-08-05T10:25:00Z',
control_type: 'production_curtailment'
}
]
}
])
};
fetch('https://api.nox.energy/v1/devices/pv/schedules', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nox.energy/v1/devices/pv/schedules",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'device_id' => 'PV1',
'schedules' => [
[
'start_time' => '2025-08-05T10:15:00Z',
'end_time' => '2025-08-05T10:20:00Z',
'control_type' => 'export_curtailment'
]
]
],
[
'device_id' => 'PV2',
'schedules' => [
[
'start_time' => '2025-08-05T10:15:00Z',
'end_time' => '2025-08-05T10:20:00Z',
'control_type' => 'production_curtailment'
]
]
],
[
'device_id' => 'PV3',
'schedules' => [
[
'start_time' => '2025-08-05T10:15:00Z',
'control_type' => 'default'
]
]
],
[
'device_id' => 'PV4',
'schedules' => [
[
'start_time' => '2025-08-05T10:15:00Z',
'end_time' => '2025-08-05T10:20:00Z',
'control_type' => 'export_curtailment'
],
[
'start_time' => '2025-08-05T10:21:00Z',
'end_time' => '2025-08-05T10:25:00Z',
'control_type' => 'production_curtailment'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.nox.energy/v1/devices/pv/schedules"
payload := strings.NewReader("[\n {\n \"device_id\": \"PV1\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV2\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV3\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"control_type\": \"default\"\n }\n ]\n },\n {\n \"device_id\": \"PV4\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n },\n {\n \"start_time\": \"2025-08-05T10:21:00Z\",\n \"end_time\": \"2025-08-05T10:25:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.nox.energy/v1/devices/pv/schedules")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("[\n {\n \"device_id\": \"PV1\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV2\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV3\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"control_type\": \"default\"\n }\n ]\n },\n {\n \"device_id\": \"PV4\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n },\n {\n \"start_time\": \"2025-08-05T10:21:00Z\",\n \"end_time\": \"2025-08-05T10:25:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nox.energy/v1/devices/pv/schedules")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"device_id\": \"PV1\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV2\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV3\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"control_type\": \"default\"\n }\n ]\n },\n {\n \"device_id\": \"PV4\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n },\n {\n \"start_time\": \"2025-08-05T10:21:00Z\",\n \"end_time\": \"2025-08-05T10:25:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n }\n]"
response = http.request(request)
puts response.read_body{
"rejected": [],
"meta": {
"energy_supplier": "Energy Supplier A",
"accepted_count": 12,
"rejected_count": 0
}
}{
"rejected": [
{
"device_id": "PV3",
"reason": "end_time must be later than the start of the next minute.",
"reason_code": 6
}
],
"meta": {
"energy_supplier": "Energy Supplier A",
"accepted_count": 10,
"rejected_count": 2
}
}{
"detail": "None of the provided device_ids allow steering or are compatible."
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}PV Control
Post Pv Control Schedule
Submit steering schedules by providing a start and end time with a 1 min granularity of when you would like
pv production/grid export curtailment to be off or 0 % grid export curtailment.
When you provide new scheduled controls for the same device
that already had an existing control, then we will overwrite any commands scheduled for the pv
with the newly provided schedules.
If an active curtailment is already active(= off or 0 %) and your newly submitted schedule overlaps with the active one,
then we will keep the active curtailment going until your end time has been reached or the start time has been reached and the
control-type is different than the active one.
start_time should be before end_time and end_time should be in the future. If not, the schedule will be rejected.
You can provide a batch of different device_id’s, each with custom or equal schedules.
You can provide multiple schedules for the same device_id but keep in mind that the next time you
update the schedule for that device_id, you will overwrite all the schedules for that device_id with the new ones you provide.
There is a limit (250) to the number of updated device_id schedules you can provide in a batch.
If you have many devices, you can split them into multiple batches.
Make sure to not send schedules that are from users that have their external steering optimization disabled or are not yet compatible with our system.
We will filter these devices out of them regardless. But it is best practice to only send us schedules for users that
want to be curtailed and are compatible.
Timestamp fields in UTC.
Time format examples:
-
2023-10-01T00:00:00Z
-
2023-10-01T00:00:00
control_type can be set to export_curtailment, production_curtailment or default.
-
export_curtailmentmeans that we will try to keep the grid export at 0 kW during the scheduled times by curtailing the pv production if needed. -
production_curtailmentmeans that we will try to keep the pv production at 0 kW during the scheduled times by curtailing the pv production if needed. -
defaultmeans that we will not curtail the pv production or export and allow the grid export to be determined by the household consumption and pv production. If theend_timeofdefaultcontrol type is reached, it will keep it as default unless another schedule overwrites it. -
It is possible to not provide an
end_timefor a schedule entry. We will handle this then as start command without reverting back to it’s original state. This is mostly recommended if you want the user to go to it’sdefaultstate. NOTE: -
The pv device might need some time to react. Please provide start times at least 1 minute in the future to ensure the device can react in time. Some may react slower than others.
POST
/
v1
/
devices
/
pv
/
schedules
Post Pv Control Schedule
curl --request POST \
--url https://api.nox.energy/v1/devices/pv/schedules \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
[
{
"device_id": "PV1",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "export_curtailment"
}
]
},
{
"device_id": "PV2",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "production_curtailment"
}
]
},
{
"device_id": "PV3",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"control_type": "default"
}
]
},
{
"device_id": "PV4",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "export_curtailment"
},
{
"start_time": "2025-08-05T10:21:00Z",
"end_time": "2025-08-05T10:25:00Z",
"control_type": "production_curtailment"
}
]
}
]
'import requests
url = "https://api.nox.energy/v1/devices/pv/schedules"
payload = [
{
"device_id": "PV1",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "export_curtailment"
}
]
},
{
"device_id": "PV2",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "production_curtailment"
}
]
},
{
"device_id": "PV3",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"control_type": "default"
}
]
},
{
"device_id": "PV4",
"schedules": [
{
"start_time": "2025-08-05T10:15:00Z",
"end_time": "2025-08-05T10:20:00Z",
"control_type": "export_curtailment"
},
{
"start_time": "2025-08-05T10:21:00Z",
"end_time": "2025-08-05T10:25:00Z",
"control_type": "production_curtailment"
}
]
}
]
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
device_id: 'PV1',
schedules: [
{
start_time: '2025-08-05T10:15:00Z',
end_time: '2025-08-05T10:20:00Z',
control_type: 'export_curtailment'
}
]
},
{
device_id: 'PV2',
schedules: [
{
start_time: '2025-08-05T10:15:00Z',
end_time: '2025-08-05T10:20:00Z',
control_type: 'production_curtailment'
}
]
},
{
device_id: 'PV3',
schedules: [{start_time: '2025-08-05T10:15:00Z', control_type: 'default'}]
},
{
device_id: 'PV4',
schedules: [
{
start_time: '2025-08-05T10:15:00Z',
end_time: '2025-08-05T10:20:00Z',
control_type: 'export_curtailment'
},
{
start_time: '2025-08-05T10:21:00Z',
end_time: '2025-08-05T10:25:00Z',
control_type: 'production_curtailment'
}
]
}
])
};
fetch('https://api.nox.energy/v1/devices/pv/schedules', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nox.energy/v1/devices/pv/schedules",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'device_id' => 'PV1',
'schedules' => [
[
'start_time' => '2025-08-05T10:15:00Z',
'end_time' => '2025-08-05T10:20:00Z',
'control_type' => 'export_curtailment'
]
]
],
[
'device_id' => 'PV2',
'schedules' => [
[
'start_time' => '2025-08-05T10:15:00Z',
'end_time' => '2025-08-05T10:20:00Z',
'control_type' => 'production_curtailment'
]
]
],
[
'device_id' => 'PV3',
'schedules' => [
[
'start_time' => '2025-08-05T10:15:00Z',
'control_type' => 'default'
]
]
],
[
'device_id' => 'PV4',
'schedules' => [
[
'start_time' => '2025-08-05T10:15:00Z',
'end_time' => '2025-08-05T10:20:00Z',
'control_type' => 'export_curtailment'
],
[
'start_time' => '2025-08-05T10:21:00Z',
'end_time' => '2025-08-05T10:25:00Z',
'control_type' => 'production_curtailment'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.nox.energy/v1/devices/pv/schedules"
payload := strings.NewReader("[\n {\n \"device_id\": \"PV1\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV2\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV3\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"control_type\": \"default\"\n }\n ]\n },\n {\n \"device_id\": \"PV4\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n },\n {\n \"start_time\": \"2025-08-05T10:21:00Z\",\n \"end_time\": \"2025-08-05T10:25:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.nox.energy/v1/devices/pv/schedules")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("[\n {\n \"device_id\": \"PV1\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV2\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV3\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"control_type\": \"default\"\n }\n ]\n },\n {\n \"device_id\": \"PV4\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n },\n {\n \"start_time\": \"2025-08-05T10:21:00Z\",\n \"end_time\": \"2025-08-05T10:25:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nox.energy/v1/devices/pv/schedules")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"device_id\": \"PV1\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV2\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n },\n {\n \"device_id\": \"PV3\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"control_type\": \"default\"\n }\n ]\n },\n {\n \"device_id\": \"PV4\",\n \"schedules\": [\n {\n \"start_time\": \"2025-08-05T10:15:00Z\",\n \"end_time\": \"2025-08-05T10:20:00Z\",\n \"control_type\": \"export_curtailment\"\n },\n {\n \"start_time\": \"2025-08-05T10:21:00Z\",\n \"end_time\": \"2025-08-05T10:25:00Z\",\n \"control_type\": \"production_curtailment\"\n }\n ]\n }\n]"
response = http.request(request)
puts response.read_body{
"rejected": [],
"meta": {
"energy_supplier": "Energy Supplier A",
"accepted_count": 12,
"rejected_count": 0
}
}{
"rejected": [
{
"device_id": "PV3",
"reason": "end_time must be later than the start of the next minute.",
"reason_code": 6
}
],
"meta": {
"energy_supplier": "Energy Supplier A",
"accepted_count": 10,
"rejected_count": 2
}
}{
"detail": "None of the provided device_ids allow steering or are compatible."
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
API Key authentication. Enter your API key in the format: YOUR_API_KEY
Body
application/json
⌘I