Allemannsdata Wiki
Manual search

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-21T02:19:33Z in 0.140 seconds.

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

Showing 2 of 2 results in compact format.

  1. station_id:
    27.13.0
    latitude:
    58.76405
    longitude:
    6.36739
  2. station_id:
    30.8.0
    latitude:
    58.86764
    longitude:
    6.5739
Show all fields in HTML
currentLink:
https://hydapi.nve.no/api/v1/Stations?CouncilName=GJESDAL&Active=OnlyActive
apiVersion:
1.0
license:
https://data.norge.no/nlod/en
createdAt:
2026-09-21T02:19:33.1441476Z
queryTime:
00:00:00.0007868
itemCount:
2
data:

2 results

  1. Open the place page for this point

    station_id:
    27.13.0
    stationName:
    Maudal
    latitude:
    58.76405
    longitude:
    6.36739
    utmEast_Z33:
    1526
    utmNorth_Z33:
    6545981
    masl:
    317
    riverName:
    Bjerkreimvassdraget
    councilNumber:
    1122
    councilName:
    Gjesdal
    countyName:
    Rogaland
    drainageBasinKey:
    929
    hierarchy:
    Bjerkreimvassdraget
    lakeArea:
    0
    lakeName:
    not reported by source
    lakeNo:
    0
    regineNo:
    027.E5
    reservoirNo:
    not reported by source
    reservoirName:
    not reported by source
    stationTypeName:
    Privat, pålagt
    stationStatusName:
    Aktiv
    drainageBasinArea:
    55.26
    drainageBasinAreaNorway:
    55.26
    gradient1085:
    5.88
    gradientBasin:
    33.33
    gradientRiver:
    22.57
    heightMinimum:
    313
    heightHypso10:
    645
    heightHypso20:
    774
    heightHypso30:
    761
    heightHypso40:
    790
    heightHypso50:
    828
    heightHypso60:
    841
    heightHypso70:
    868
    heightHypso80:
    894
    heightHypso90:
    929
    heightMaximum:
    1015
    lengthKmBasin:
    21.66
    lengthKmRiver:
    24.72
    percentAgricul:
    0
    percentBog:
    0.33
    percentEffBog:
    not reported by source
    percentEffLake:
    6.89
    percentForest:
    1.31
    percentGlacier:
    0
    percentLake:
    18.74
    percentMountain:
    78.53
    percentUrban:
    0
    utmZoneGravi:
    33
    utmEastGravi:
    11249
    utmNorthGravi:
    6550829
    utmZoneInlet:
    33
    utmEastInlet:
    21311
    utmNorthInlet:
    6554161
    utmZoneOutlet:
    not reported by source
    utmEastOutlet:
    not reported by source
    utmNorthOutlet:
    not reported by source
    annualRunoff:
    148.91
    specificDischarge:
    85.42
    regulationArea:
    50.45
    areaReservoirs:
    4.35
    volumeReservoirs:
    63
    regulationPartReservoirs:
    0.42
    transferAreaIn:
    0
    transferAreaOut:
    0
    reservoirAreaIn:
    0
    reservoirAreaOut:
    0
    reservoirVolumeIn:
    0
    reservoirVolumeOut:
    0
    remainingArea:
    4.79
    numberReservoirs:
    1
    firstYearRegulation:
    1930
    catchmentRegTypeName:
    regulert m/magasinregulering
    owner:
    LYSE PRODUKSJON AS
    qNumberOfYears:
    not reported by source
    qStartYear:
    not reported by source
    qEndYear:
    not reported by source
    qm:
    not reported by source
    q5:
    not reported by source
    q10:
    not reported by source
    q20:
    not reported by source
    q50:
    not reported by source
    hm:
    not reported by source
    h5:
    not reported by source
    h10:
    not reported by source
    h20:
    not reported by source
    h50:
    not reported by source
    culQm:
    not reported by source
    culQ5:
    not reported by source
    culQ10:
    not reported by source
    culQ20:
    not reported by source
    culQ50:
    not reported by source
    culHm:
    not reported by source
    culH5:
    not reported by source
    culH10:
    not reported by source
    culH20:
    not reported by source
    culH50:
    not reported by source
    seriesList:

    1 results

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

      3 results

      1. resTime:
        0
        method:
        Instantaneous
        timeOffset:
        0
        dataFromTime:
        1943-01-01T11:00:00Z
        dataToTime:
        2026-09-15T19:00:00Z
      2. resTime:
        60
        method:
        Instantaneous
        timeOffset:
        0
        dataFromTime:
        1946-07-19T05:00:00Z
        dataToTime:
        2026-09-15T19:00:00Z
      3. resTime:
        1440
        method:
        Instantaneous
        timeOffset:
        0
        dataFromTime:
        1944-01-01T11:00:00Z
        dataToTime:
        2026-09-15T11:00:00Z

  2. Open the place page for this point

    station_id:
    30.8.0
    stationName:
    Øvstabøstøl
    latitude:
    58.86764
    longitude:
    6.5739
    utmEast_Z33:
    14864
    utmNorth_Z33:
    6555934
    masl:
    578
    riverName:
    Dirdalsåna
    councilNumber:
    1122
    councilName:
    Gjesdal
    countyName:
    Rogaland
    drainageBasinKey:
    968
    hierarchy:
    Dirdalsåna
    lakeArea:
    0
    lakeName:
    not reported by source
    lakeNo:
    0
    regineNo:
    030.2B
    reservoirNo:
    not reported by source
    reservoirName:
    not reported by source
    stationTypeName:
    Privat, pålagt
    stationStatusName:
    Aktiv
    drainageBasinArea:
    49.85
    drainageBasinAreaNorway:
    49.85
    gradient1085:
    20.41
    gradientBasin:
    31.9
    gradientRiver:
    32.76
    heightMinimum:
    570
    heightHypso10:
    753
    heightHypso20:
    797
    heightHypso30:
    904
    heightHypso40:
    914
    heightHypso50:
    928
    heightHypso60:
    940
    heightHypso70:
    949
    heightHypso80:
    996
    heightHypso90:
    1033
    heightMaximum:
    1130
    lengthKmBasin:
    10.24
    lengthKmRiver:
    13.46
    percentAgricul:
    0
    percentBog:
    0.28
    percentEffBog:
    not reported by source
    percentEffLake:
    0.9
    percentForest:
    0.13
    percentGlacier:
    0
    percentLake:
    8.73
    percentMountain:
    90.85
    percentUrban:
    0
    utmZoneGravi:
    33
    utmEastGravi:
    18082
    utmNorthGravi:
    6558768
    utmZoneInlet:
    33
    utmEastInlet:
    22215
    utmNorthInlet:
    6561030
    utmZoneOutlet:
    not reported by source
    utmEastOutlet:
    not reported by source
    utmNorthOutlet:
    not reported by source
    annualRunoff:
    134.27
    specificDischarge:
    85.18
    regulationArea:
    38.38
    areaReservoirs:
    0.71
    volumeReservoirs:
    1.1
    regulationPartReservoirs:
    0.01
    transferAreaIn:
    0
    transferAreaOut:
    38.38
    reservoirAreaIn:
    0
    reservoirAreaOut:
    0.15
    reservoirVolumeIn:
    0
    reservoirVolumeOut:
    0.15
    remainingArea:
    11.57
    numberReservoirs:
    2
    firstYearRegulation:
    1983
    catchmentRegTypeName:
    regulert m/magasin og uregulert restfelt
    owner:
    SIRA KVINA KRAFTSELSKAP
    qNumberOfYears:
    21
    qStartYear:
    1986
    qEndYear:
    2018
    qm:
    24.7718
    q5:
    31.4211
    q10:
    35.0756
    q20:
    38.024
    q50:
    41.1691
    hm:
    2.675
    h5:
    2.8633
    h10:
    2.9568
    h20:
    3.028
    h50:
    3.1005
    culQm:
    41.1862
    culQ5:
    52.2414
    culQ10:
    58.3175
    culQ20:
    63.2196
    culQ50:
    68.4487
    culHm:
    3.1009
    culH5:
    3.3321
    culH10:
    3.4468
    culH20:
    3.5343
    culH50:
    3.6232
    seriesList:

    2 results

    1. parameterName:
      Vannstand
      parameter:
      1000
      versionNo:
      1
      unit:
      m
      serieFrom:
      1986-04-14T00:00:00
      serieTo:
      not reported by source
      resolutionList:

      3 results

      1. resTime:
        0
        method:
        Instantaneous
        timeOffset:
        0
        dataFromTime:
        1986-04-14T15:00:00Z
        dataToTime:
        2026-09-21T01:00:00Z
      2. resTime:
        60
        method:
        Mean
        timeOffset:
        0
        dataFromTime:
        1986-04-14T16:00:00Z
        dataToTime:
        2026-09-21T01:00:00Z
      3. resTime:
        1440
        method:
        Mean
        timeOffset:
        0
        dataFromTime:
        1986-04-15T11:00:00Z
        dataToTime:
        2026-09-20T11: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:
        1986-04-14T15:00:00Z
        dataToTime:
        2026-09-21T01:00:00Z
      2. resTime:
        60
        method:
        Mean
        timeOffset:
        0
        dataFromTime:
        1986-04-14T16:00:00Z
        dataToTime:
        2026-09-21T01:00:00Z
      3. resTime:
        1440
        method:
        Mean
        timeOffset:
        0
        dataFromTime:
        1986-04-15T11:00:00Z
        dataToTime:
        2026-09-20T11:00:00Z
limit:
25
offset:
0
returned:
2
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.

AI agent? Read the complete navigation and programming guide.