Model Forecasts

Get Model Forecast

Get rebase model forecast values for a zone.

Returns the latest-issued value per timestamp over [start, end) — each hourly issue supersedes the previous one where they overlap. The response's provenance (category FORECAST) carries the issue_time of the most recent issue used.

Response fields:

  • value_mw: forecast values in MW.
  • model: the model slug the response was served from.
get/v1/zone/{zone_key}/forecast

Request

  • Base URL: https://grid.rebase.energy/api
  • URL: https://grid.rebase.energy/api/v1/zone/{zone_key}/forecast
  • Auth: one of:
    • API key in query parameter api_key
    • API key in header X-API-Key

Path parameters

zone_keystring required

Query parameters

variable'demand' | 'wind' | 'solar' required

Forecast variable: demand, wind, or solar.

modelstring nullable

Model name or slug. May be omitted when exactly one model has forecasts for this zone/variable; with several models registered, omitting it returns 400 listing the available slugs.

startstring date-time nullable

Start of time range (tz-aware ISO 8601), inclusive. Default: now.

endstring date-time nullable

End of time range (tz-aware ISO 8601), exclusive. Default: start + 24h.

Response

Successful Response

zone_keystring required
variable'demand' | 'wind' | 'solar' required

Forecast variable: demand, wind, or solar.

modelstring required

Model slug this response was served from (lowercase, hyphen-separated normalisation of the model name).

data_typestring
unitstring
startstring required

Start of time range (ISO 8601), inclusive

endstring required

End of time range (ISO 8601), exclusive

Changes

No recorded changes to this operation across all 1 revision of this API.