{"source":"nve","operation":"search_stations","description":"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).","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)","parameters":[{"name":"municipality","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"Municipality name (HydAPI field CouncilName).","unit":null},{"name":"county","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"County name.","unit":null},{"name":"station_name","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"Station name filter.","unit":null},{"name":"active_only","type":"boolean","schema":{"type":"boolean"},"required":false,"default":true,"description":"Return only active stations by default.","unit":null},{"name":"limit","type":"integer","schema":{"type":"integer"},"required":false,"default":25,"description":"Maximum stations returned (default 25, maximum 100). Unit: items.","unit":"items"},{"name":"offset","type":"integer","schema":{"type":"integer"},"required":false,"default":0,"description":"Number of matching stations to skip (default 0). Unit: items.","unit":"items"}],"json_get_url_template":"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","schema_scope":"#/data in the successful operation envelope","response_schema":{"type":"object","properties":{"currentLink":{"type":["string","null"],"format":"uri"},"apiVersion":{"type":["string","null"]},"license":{"type":["string","null"],"format":"uri"},"createdAt":{"type":["string","null"],"format":"date-time"},"queryTime":{"type":["string","null"]},"itemCount":{"type":["integer","null"]},"status":{"type":["string","null"]},"data":{"type":"array","items":{"type":"object","properties":{"station_id":{"type":"string"},"stationName":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"masl":{"type":["number","null"]},"riverName":{"type":["string","null"]},"councilNumber":{"type":["string","null"]},"councilName":{"type":["string","null"]},"countyName":{"type":["string","null"]},"stationTypeName":{"type":["string","null"]},"stationStatusName":{"type":["string","null"]},"seriesList":{"type":"array","items":{"type":"object","properties":{"parameter":{"type":["integer","null"]},"parameterName":{"type":["string","null"]},"versionNo":{"type":["integer","null"]},"unit":{"type":["string","null"]},"serieFrom":{"type":["string","null"],"format":"date-time"},"serieTo":{"type":["string","null"],"format":"date-time"},"resolutionList":{"type":"array","items":{"type":"object","properties":{"resTime":{"type":["integer","null"]},"method":{"type":["string","null"]},"timeOffset":{"type":["integer","null"]},"dataFromTime":{"type":["string","null"],"format":"date-time"},"dataToTime":{"type":["string","null"],"format":"date-time"}}}}}}}},"required":["station_id"]}},"limit":{"type":"integer"},"offset":{"type":"integer"},"returned":{"type":"integer"},"has_more_results":{"type":"boolean"},"truncated":{"type":"boolean"},"next_offset":{"type":"integer"}},"required":["data"]},"response_schema_status":{"status":"declared","codegen_safe":true,"description":"Maintained response contract."},"entity_projection":{"status":"projected","entity_types":["hydrology_station"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"error_contract":{"scope":"top-level HTTP error response; never part of a success payload","schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object"}},"additionalProperties":false,"required":["code","message","retryable"]},"suggestion":{"type":"string"},"_meta":{"type":"object","properties":{"retrieved_at":{"type":"string","format":"date-time"},"language":{"type":"string","const":"en"},"content_languages":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object"}}},"required":["retrieved_at","language","content_languages","sources"]},"_links":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"api_index":{"type":"string","format":"uri"},"feedback":{"type":"string","format":"uri"}},"required":["self","api_index","feedback"],"additionalProperties":false}},"additionalProperties":false,"required":["error","suggestion","_meta","_links"]},"statuses":{"400":{"codes":["MISSING_PARAMETER","INVALID_PARAMETER","INVALID_REQUEST"],"retryable":false},"404":{"codes":["SOURCE_NOT_FOUND","OPERATION_NOT_FOUND","ENTITY_NOT_FOUND"],"retryable":false},"429":{"codes":["RATE_LIMITED","GATEWAY_RATE_LIMITED"],"retryable":true},"502":{"codes":["SOURCE_UNAVAILABLE"],"retryable":true},"500":{"codes":["INTERNAL_ERROR"],"retryable":true}}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/nve/search_stations/schema","operation":"https://allemannsdata.com/wiki/api/v1/kilder/nve/search_stations","source":"https://allemannsdata.com/wiki/api/v1/kilder/nve","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"},"output_fields":["currentLink","apiVersion","license","createdAt","queryTime","itemCount","status","data","data[].station_id","data[].stationName","data[].latitude","data[].longitude","data[].masl","data[].riverName","data[].councilNumber","data[].councilName","data[].countyName","data[].stationTypeName","data[].stationStatusName","data[].seriesList","data[].seriesList[].parameter","data[].seriesList[].parameterName","data[].seriesList[].versionNo","data[].seriesList[].unit","data[].seriesList[].serieFrom","data[].seriesList[].serieTo","data[].seriesList[].resolutionList","limit","offset","returned"],"output_fields_truncated":true,"canonical_field_aliases":{"latitude":["data[].latitude"],"longitude":["data[].longitude"]},"response_example":{"source":"nve","operation":"search_stations","parameters":{"municipality":"example value","county":"example value","station_name":"Example","active_only":true,"limit":25,"offset":0},"data":{"currentLink":"https://example.invalid/resource","apiVersion":"example value","license":"https://example.invalid/resource","createdAt":"2026-01-15T12:00:00Z","queryTime":"2026-01-15T12:00:00Z","itemCount":1,"status":"example value","data":[{"station_id":"example-id","stationName":"Example","latitude":59.91,"longitude":10.75,"masl":1.0,"riverName":"Example","councilNumber":"example value","councilName":"Example","countyName":"Example","stationTypeName":"Example","stationStatusName":"Example","seriesList":[{"parameter":1,"parameterName":"Example","versionNo":1,"unit":"example value","serieFrom":"2026-01-15T12:00:00Z","serieTo":"2026-01-15T12:00:00Z","resolutionList":[{"resTime":1,"method":"example value","timeOffset":1,"dataFromTime":"2026-01-15T12:00:00Z","dataToTime":"2026-01-15T12:00:00Z"}]}]}],"limit":1,"offset":1,"returned":1,"has_more_results":true,"truncated":true,"next_offset":1},"entities":[],"_meta":{"retrieved_at":"2026-01-15T12:00:00Z","language":"en","content_languages":["en"],"sources":[{"id":"nve","name":"NVE HydAPI","description":"Hydrological stations and observations for water level, discharge, temperature, snow and groundwater, plus every hydro and wind power plant with owner, capacity and production.","cache_ttl_seconds":60,"documentation":"https://hydapi.nve.no/UserDocumentation/","rate_limit":"The gateway monitors upstream quota information and caches metadata."}]},"_provenance":{"data":{"source":"nve","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/nve"},"entities":{"source":"nve","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/nve","derived_from":"#/data","description":"Normalized projection of data."}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/nve/search_stations","source":"https://allemannsdata.com/wiki/api/v1/kilder/nve","wiki":"https://allemannsdata.com/wiki/kilder/nve/search_stations/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}}