search_stations

Find NVE hydrological stations and their available time series.

Signature: search_stations(municipality: string, optional, default None; county: string, optional, default None; station_name: string, optional, default None; active_only: yes/no, optional, default True; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0)

Direct GET

For navigating agents: open the HTML page with parameters in the URL. The result is fetched and displayed without screenshots or form filling.

Open this validated HTML GET URL

https://allemannsdata.com/wiki/kilder/nve/search_stations/?municipality={municipality}&county={county}&station_name={station_name}&active_only=true&limit=25&offset=0

Replace {municipality}, {county}, {station_name}, {active_only}, {limit}, {offset} with values. Remove unused optional parameters from the URL.

For software and dashboards: Read the operation descriptor. The JSON GET template is https://allemannsdata.com/wiki/api/v1/kilder/nve/search_stations?municipality={municipality}&county={county}&station_name={station_name}&active_only=true&limit=25&offset=0. Open this exact request as JSON.

ParameterRequirementJSON typeDescription
municipalityoptionalunionMunicipality name (HydAPI field CouncilName).
countyoptionalunionCounty name.
station_nameoptionalunionStation name filter.
active_onlyoptionalbooleanReturn only active stations by default.
limitoptionalintegerMaximum stations returned (default 25, maximum 100). Unit: items.
offsetoptionalintegerNumber of matching stations to skip (default 0). Unit: items.
Generated JavaScript, Python and response structure

Use JSON when the user requests code, machine-readable data, value extraction or further computation. Use the HTML GET page to identify the correct source and verify parameters.

Example for generated JavaScript and Python

https://allemannsdata.com/wiki/api/v1/kilder/nve/search_stations?municipality={municipality}&county={county}&station_name={station_name}&active_only=true&limit=25&offset=0

Replace URL placeholders and remove unused optional parameters.

JavaScript in a dashboard

const url = "https://allemannsdata.com/wiki/api/v1/kilder/nve/search_stations?municipality={municipality}&county={county}&station_name={station_name}&active_only=true&limit=25&offset=0";
const response = await fetch(url);
if (!response.ok) {
  const failure = await response.json();
  throw new Error(`${failure.error.code}: ${failure.error.message} ${failure.suggestion}`);
}
const result = await response.json();
const data = result.data;

Python without additional packages

import json
from urllib.request import urlopen

url = "https://allemannsdata.com/wiki/api/v1/kilder/nve/search_stations?municipality={municipality}&county={county}&station_name={station_name}&active_only=true&limit=25&offset=0"
with urlopen(url) as response:
    result = json.load(response)
data = result["data"]

Response structure

{
  "source": "nve",
  "operation": "search_stations",
  "parameters": {},
  "data": {},
  "entities": [],
  "_meta": {"retrieved_at": "...", "sources": [], "cache": {}},
  "_links": {"self": "...", "source": "...", "wiki": "...", "feedback": "..."}
}
Form for manual use

The form is a fallback for people and browser agents that cannot open the GET URL directly.

Type: string. Municipality name (HydAPI field CouncilName).
Type: string. County name.
Type: string. Station name filter.
Type: yes/no. Return only active stations by default.
Type: integer. Maximum stations returned (default 25, maximum 100). Unit: items.
Type: integer. Number of matching stations to skip (default 0). Unit: items.

Result

Source: NVE HydAPI. Retrieved 2026-09-24T01:05:15Z in 0.176 seconds.

Search scope: Municipality-filtered results cover all of KRAGERØ municipality.

Showing 1 of 1 results in compact format.

  1. station_id:
    17.10.0
    latitude:
    58.96404
    longitude:
    9.32025
Show all fields in HTML
currentLink:
https://hydapi.nve.no/api/v1/Stations?CouncilName=KRAGER%C3%98&Active=OnlyActive
apiVersion:
1.0
license:
https://data.norge.no/nlod/en
createdAt:
2026-09-24T01:05:15.7208352Z
queryTime:
00:00:00.0012876
itemCount:
1
data:

1 results

  1. station_id:
    17.10.0
    stationName:
    Dalsfoss ndf.
    latitude:
    58.96404
    longitude:
    9.32025
    utmEast_Z33:
    173596
    utmNorth_Z33:
    6549928
    masl:
    39
    riverName:
    Kragerøvassdraget
    councilNumber:
    4014
    councilName:
    Kragerø
    countyName:
    Telemark
    drainageBasinKey:
    709
    hierarchy:
    Kragerøvassdraget
    lakeArea:
    0
    lakeName:
    not reported by source
    lakeNo:
    0
    regineNo:
    017.B6
    reservoirNo:
    not reported by source
    reservoirName:
    not reported by source
    stationTypeName:
    Privat, ikke pålagt
    stationStatusName:
    Aktiv
    drainageBasinArea:
    1159.59
    drainageBasinAreaNorway:
    1159.59
    gradient1085:
    2.59
    gradientBasin:
    25.48
    gradientRiver:
    6.73
    heightMinimum:
    37
    heightHypso10:
    158
    heightHypso20:
    179
    heightHypso30:
    222
    heightHypso40:
    266
    heightHypso50:
    385
    heightHypso60:
    451
    heightHypso70:
    527
    heightHypso80:
    607
    heightHypso90:
    690
    heightMaximum:
    911
    lengthKmBasin:
    56.05
    lengthKmRiver:
    80.4
    percentAgricul:
    1.14
    percentBog:
    2.99
    percentEffBog:
    not reported by source
    percentEffLake:
    0.2
    percentForest:
    82.45
    percentGlacier:
    0
    percentLake:
    6.99
    percentMountain:
    2.92
    percentUrban:
    0.09
    utmZoneGravi:
    33
    utmEastGravi:
    154133
    utmNorthGravi:
    6567175
    utmZoneInlet:
    33
    utmEastInlet:
    134813
    utmNorthInlet:
    6590091
    utmZoneOutlet:
    not reported by source
    utmEastOutlet:
    not reported by source
    utmNorthOutlet:
    not reported by source
    annualRunoff:
    975.35
    specificDischarge:
    26.65
    regulationArea:
    1156.87
    areaReservoirs:
    38.24
    volumeReservoirs:
    175
    regulationPartReservoirs:
    0.18
    transferAreaIn:
    0
    transferAreaOut:
    0
    reservoirAreaIn:
    0
    reservoirAreaOut:
    0
    reservoirVolumeIn:
    0
    reservoirVolumeOut:
    0
    remainingArea:
    2.83
    numberReservoirs:
    5
    firstYearRegulation:
    2004
    catchmentRegTypeName:
    regulert m/magasinregulering
    owner:
    SKAGERAK KRAFT AS
    qNumberOfYears:
    114
    qStartYear:
    1909
    qEndYear:
    2022
    qm:
    217.9216
    q5:
    291.782
    q10:
    337.5653
    q20:
    376.5564
    q50:
    420.7328
    hm:
    39.8813
    h5:
    40.4615
    h10:
    40.7936
    h20:
    41.0635
    h50:
    41.357
    culQm:
    235.8729
    culQ5:
    315.8175
    culQ10:
    365.3723
    culQ20:
    407.5753
    culQ50:
    455.3907
    culHm:
    40.0283
    culH5:
    40.6381
    culH10:
    40.9872
    culH20:
    41.2708
    culH50:
    41.5792
    seriesList:

    2 results

    1. parameterName:
      Vannstand
      parameter:
      1000
      versionNo:
      1
      unit:
      m
      serieFrom:
      1908-10-05T00:00:00
      serieTo:
      not reported by source
      resolutionList:

      3 results

      1. resTime:
        0
        method:
        Instantaneous
        timeOffset:
        0
        dataFromTime:
        1908-10-05T11:00:00Z
        dataToTime:
        2026-09-23T23:00:00Z
      2. resTime:
        60
        method:
        Mean
        timeOffset:
        0
        dataFromTime:
        2005-01-01T00:00:00Z
        dataToTime:
        2026-09-23T23:00:00Z
      3. resTime:
        1440
        method:
        Mean
        timeOffset:
        0
        dataFromTime:
        1908-10-05T11:00:00Z
        dataToTime:
        2026-09-23T11:00:00Z
    2. parameterName:
      Vannføring
      parameter:
      1001
      versionNo:
      1
      unit:
      m³/s
      serieFrom:
      not reported by source
      serieTo:
      not reported by source
      resolutionList:

      3 results

      1. resTime:
        0
        method:
        Instantaneous
        timeOffset:
        0
        dataFromTime:
        1908-10-05T11:00:00Z
        dataToTime:
        2026-09-23T23:00:00Z
      2. resTime:
        60
        method:
        Mean
        timeOffset:
        0
        dataFromTime:
        2005-01-01T00:00:00Z
        dataToTime:
        2026-09-23T23:00:00Z
      3. resTime:
        1440
        method:
        Mean
        timeOffset:
        0
        dataFromTime:
        1908-10-05T11:00:00Z
        dataToTime:
        2026-09-23T11:00:00Z
limit:
25
offset:
0
returned:
1
has_more_results:
no
truncated:
no
Will you use the result in generated code?

Open the same result as JSON

Is data missing or incorrect? Send feedback about this result.

Continue exploring

How an AI agent should use this page

Ground rule: Navigate with HTML GET links to keep explanations and relationships. Use the page's JSON alternative only when concrete values must be extracted, compared or computed.

How to use the search_stations lookup

  1. Replace the placeholders in the HTML GET template; remove optional parameters you do not need.
  2. Check types, units, limits and ID formats in the parameter table.
  3. Follow linked results to canonical pages before combining sources.

Misreading to avoid: An empty list means "no results for this lookup". An error message or unavailable source does not mean the data does not exist.

Source-specific next step

Go to the source page for other operations. Use the JSON template only after the HTML result shows that the parameters and source are correct.