gridded

The gridded response option attaches time-limited URLs for the gridded outputs identified by the subscription trigger. The model, initialization time, and forecast hours are derived from the event, so the customer supplies no endpoint options.

Configuration Options

Option	Type	Description
type Required	string	Must be gridded .

Do not send an options object for this response type.

Subscription Behavior

Subscription	Attached response
initialization_time.available	One output entry for every forecast hour in the completed initialization.
forecast_hour.available	One output entry for the forecast hour that triggered the delivery.

Response Fields

Field	Type	Description
outputs	object[]	Gridded outputs available for the trigger.
forecast_hour	integer	Hours from the event initialization time.
url	string	Time-limited gridded API URL.Fetch promptly because signed URLs expire.

Example Response Option

1 "response_options": {"response_options": {

2 "type": "gridded" "type": "gridded"

3 }}

Example data.response

1 "response": {"response": {

2 "outputs": [ "outputs": [

3 { {

4 "forecast_hour": 0, "forecast_hour": 0,

5 "url": "https://api.windbornesystems.com/forecasts/v1/wm-6/gridded?initialization_time=2026-03-09T00%3A00%3A00Z&forecast_hour=0&variable=all&format=zarr&dlviz_token=...&include_distribution=true" "url": "https://api.windbornesystems.com/forecasts/v1/wm-6/gridded?initialization_time=2026-03-09T00%3A00%3A00Z&forecast_hour=0&variable=all&format=zarr&dlviz_token=...&include_distribution=true"

6 }, },

7 { {

8 "forecast_hour": 6, "forecast_hour": 6,

9 "url": "https://api.windbornesystems.com/forecasts/v1/wm-6/gridded?initialization_time=2026-03-09T00%3A00%3A00Z&forecast_hour=6&variable=all&format=zarr&dlviz_token=...&include_distribution=true" "url": "https://api.windbornesystems.com/forecasts/v1/wm-6/gridded?initialization_time=2026-03-09T00%3A00%3A00Z&forecast_hour=6&variable=all&format=zarr&dlviz_token=...&include_distribution=true"

10 } }

11 ] ]

12 }}