Endpoint reference

Each second-level section describes one endpoint. The first table of a section is its basic information, which the overview page reads into a summary table; the tables that follow describe parameters and the response. Error responses share one shape and are listed separately under Error codes.

All endpoints are served from https://api.northlight.example and answer GET only. Requests carry these headers:

List endpoints paginate with a cursor: a response that has more rows carries page.next, and passing it as cursor returns the next page. Cursors are opaque and expire after ten minutes.

Current conditions

Returns the latest observation from one station.

The response is one observation object. Readings older than fifteen minutes carry stale: true; a station that has not reported for six hours is answered with 503 upstream_delayed instead.

Responses are cached at the edge for sixty seconds and carry an ETag.

Hourly forecast

Returns up to 48 hourly forecast points for one station.

fields narrows the response to the named groups; without it every group is returned. The response carries the model run that produced the points and the points themselves:

{
  "station": "OSL-01",
  "issuedAt": "2026-09-22T05:05:00Z",
  "points": [
    {
      "validAt": "2026-09-22T07:00:00Z",
      "temperature": 12.1,
      "windSpeed": 4.0,
      "windDirection": 250,
      "precipitationProbability": 0.15,
      "precipitationAmount": 0.0,
      "cloudCover": 0.9
    }
  ],
  "units": {
    "temperature": "C",
    "windSpeed": "m/s",
    "precipitationAmount": "mm"
  }
}

Beyond 24 hours the Community plan receives no points; the other plans receive up to 48. See Plans compared.

Daily forecast

Returns one forecast summary per calendar day, up to seven days ahead.

Each day carries temperatureMin, temperatureMax, precipitationTotal, precipitationProbability, the dominant conditions word, and sunrise and sunset in UTC. The first day is today in the station's local time, which may already be partly in the past; its minimum and maximum cover the whole day.

Observation history

Returns past observations from one station in a time range, oldest first.

How far back from may reach depends on the plan's history retention; a range that starts earlier is answered with 400 range_too_wide rather than being silently clipped. A range that spans more than 31 days at the 10m step is rejected the same way; use 1h or 1d for long ranges.

{
  "station": "OSL-01",
  "step": "1h",
  "rows": [
    {
      "observedAt": "2026-09-21T00:00:00Z",
      "temperature": 9.8,
      "temperatureMin": 9.1,
      "temperatureMax": 10.4,
      "windSpeed": 2.1,
      "precipitation": 0.0
    }
  ],
  "page": { "next": "eyJvIjoiMjAyNi0wOS0yMVQwMTowMDowMFoifQ" },
  "units": { "temperature": "C", "windSpeed": "m/s", "precipitation": "mm" }
}

Station directory

Lists the stations a key may read, with their location and status.

Each row carries the code, the site name, coordinates, elevation, status and the instant of the last observation. Retired stations are included only when status=retired is asked for, so a client that lists stations sees them disappear rather than fail.

{
  "stations": [
    {
      "code": "OSL-01",
      "site": "Oslo",
      "latitude": 59.9423,
      "longitude": 10.7203,
      "elevation": 94,
      "status": "active",
      "lastObservedAt": "2026-09-22T06:00:00Z"
    },
    {
      "code": "BGO-02",
      "site": "Bergen",
      "latitude": 60.3982,
      "longitude": 5.3241,
      "elevation": 320,
      "status": "maintenance",
      "lastObservedAt": "2026-09-19T14:10:00Z"
    }
  ],
  "page": { "next": null }
}

Station detail

Returns one station's metadata, including its sensors and time zone.

The detail adds to the directory row the station's IANA time zone, its sensor list with the make and the installation date of each, the date it first reported and, for a retired station, the date it stopped. Metadata changes rarely; cache it for a day.

Weather alerts Beta

Lists active severe-weather alerts for a region, relayed from the national service.

Each alert carries event (wind, rain, snow, ice or flood), severity, onset, expires and a headline in the region's language. The endpoint is in beta: its shape may change with thirty days' notice rather than ninety, and it is available on the Business and Enterprise plans.