> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexenergie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /forecasts/day-ahead — Day-Ahead Price Forecast

> Retrieve hourly day-ahead electricity price forecasts for the Spanish OMIE market. Returns 24 hourly EUR/MWh values with confidence bounds.

Requires authentication. API keys that declare fine-grained scopes need `forecasts:read`.

## Latest run

```bash theme={null}
GET /api/v1/forecasts/latest?market_id=omie_es&product=da
```

<ParamField query="market_id" type="string" required>
  Market id, e.g. `omie_es`.
</ParamField>

<ParamField query="product" type="string" required>
  `da`, `ida1`, `ida2`, or `ida3`.
</ParamField>

Returns the most recently issued forecast for that product.

## Filtered series

```bash theme={null}
GET /api/v1/forecasts?market_id=omie_es&product=da&date=2026-08-20
```

Or a UTC range:

```bash theme={null}
GET /api/v1/forecasts?market_id=omie_es&product=da&from=2026-08-19T22:00:00Z&to=2026-08-20T22:00:00Z
```

<ParamField query="date" type="date">
  Delivery day in the market timezone (Europe/Madrid). Mutually exclusive with `from` / `to`.
</ParamField>

<ParamField query="from" type="datetime">
  UTC range start (inclusive). Requires `to`.
</ParamField>

<ParamField query="to" type="datetime">
  UTC range end (exclusive). Requires `from`.
</ParamField>

## Response

```json theme={null}
{
  "market_id": "omie_es",
  "product": "da",
  "market_product_id": "omie_es_da",
  "forecast_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "issued_at": "2026-08-19T10:05:00+00:00",
  "unit": "EUR/MWh",
  "range_start": "2026-08-19T22:00:00+00:00",
  "range_end": "2026-08-20T22:00:00+00:00",
  "points": [
    {
      "time": "2026-08-19T22:00:00+00:00",
      "value": 72.15,
      "p10": 61.0,
      "p90": 84.2
    }
  ]
}
```

<Note>
  `range_start` / `range_end` are null on `/latest` when the full stored horizon is returned.
</Note>