Get Fleet Pv Typical Production

curl --request GET \
  --url https://api.nox.energy/v1/fleet/pv/production/typical-production \
  --header 'x-api-key: <api-key>'

{
  "data": [
    {
      "forecast_time": "2025-05-01T07:45:00.000Z",
      "production": 42.75
    },
    {
      "forecast_time": "2025-05-01T08:00:00.000Z",
      "production": 48.1
    }
  ],
  "meta": {
    "energy_supplier": "Energy Supplier A",
    "generation_time": "2025-06-01T07:30:00Z",
    "production_unit": "kWh",
    "granularity": "15min",
    "output_timezone": "UTC"
  }
}

Device Production

Get Fleet Pv Typical Production

Get the fleet level typical production forecast for the whole PV pool associated with your energy supplier account in kWh with 15min granularity.

The typical production represents the aggregated production the fleet would have produced under the forecasted weather conditions if no curtailment had taken place. It is generated for a given generation_time (the moment the forecast was produced) and covers the 15min time_buckets within the requested start_time and end_time window.

This is typically used to quantify the impact of a curtailment event: by comparing the actual (curtailed) production of the fleet against this typical production, you can estimate the amount of power that was curtailed compared to a scenario where no curtailment would have happened.

The timestamp (forecast_time) refers to the production that happens in the next 15 minutes after the timestamp.

All timestamps are in UTC.

GET

/

v1

/

fleet

/

pv

/

production

/

typical-production

Get Fleet Pv Typical Production

curl --request GET \
  --url https://api.nox.energy/v1/fleet/pv/production/typical-production \
  --header 'x-api-key: <api-key>'

{
  "data": [
    {
      "forecast_time": "2025-05-01T07:45:00.000Z",
      "production": 42.75
    },
    {
      "forecast_time": "2025-05-01T08:00:00.000Z",
      "production": 48.1
    }
  ],
  "meta": {
    "energy_supplier": "Energy Supplier A",
    "generation_time": "2025-06-01T07:30:00Z",
    "production_unit": "kWh",
    "granularity": "15min",
    "output_timezone": "UTC"
  }
}

Authorizations

x-api-key

string

header

required

API Key authentication. Enter your API key in the format: YOUR_API_KEY

Query Parameters

generation_time

string

required

The datetime at which the forecast was generated. Only the forecast produced at this exact generation_time is returned. The time is in UTC in ISO 8601 format.

Time format examples:

2023-10-01T00:00:00Z
2023-10-01T00:00:00

start_time

string

required

Start of the time window (inclusive) of the forecasted 15min production buckets to return. Filters on the time_bucket of the forecast. The time is in UTC in ISO 8601 format.

Time format examples:

2023-10-01T00:00:00Z
2023-10-01T00:00:00

end_time

string

required

End of the time window (inclusive) of the forecasted 15min production buckets to return. Filters on the time_bucket of the forecast. The time is in UTC in ISO 8601 format.

Time format examples:

2023-10-01T00:00:00Z
2023-10-01T00:00:00

Response

Successful response

data

PVFleetTypicalProductionData · object[] | null

List of fleet level typical production buckets.

Show child attributes

meta

PVFleetTypicalProductionMeta · object | null

Response metadata

Show child attributes

Get Devices Pv Production Forecast Realtime Get Devices Pv Typical Production