{"source":"nve","operation":"get_hydro_percentiles","description":"Get day-of-year percentile bands (the seasonal \"normal\") for a station's\nparameter, computed by NVE over the station's full record. Use them as the\nreference band to judge whether an observed value is high or low for the\ntime of year, e.g. is inflow above or below normal right now. Signature: get_hydro_percentiles(station_id: string, required; parameter: integer, required; date: string, optional, default None; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0).","signature":"get_hydro_percentiles(station_id: string, required; parameter: integer, required; date: string, optional, default None; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0)","parameters":[{"name":"station_id","type":"string","schema":{"type":"string"},"required":true,"default":null,"description":"NVE station id, e.g. \"1.200.0\" (from find_hydro_stations).","unit":null},{"name":"parameter","type":"integer","schema":{"type":"integer"},"required":true,"default":null,"description":"Numeric parameter id, e.g. 1001=discharge, 1000=water level.","unit":null},{"name":"date","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"\"today\" or a \"MMDD\" day of year, e.g. \"0807\", to get that one day's band instead of the whole year. Omit for all 366 rows.","unit":null},{"name":"limit","type":"integer","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"display_type":"integer","required":false,"default":25,"description":"Maximum list items returned by the gateway (default 25, maximum 100).","unit":"items"},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page.","unit":"items"}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/nve/get_hydro_percentiles?station_id={station_id}&parameter={parameter}&date={date}&limit=25&offset=0","schema_scope":"#/data in the successful operation envelope","response_schema":{"type":"object","properties":{"station_id":{"type":"string"},"parameter":{"type":"integer"},"percentiles":{"type":"array","items":{"type":"object","properties":{"date_mmdd":{"type":"string"},"mean":{"type":"number"},"p10":{"type":"number"},"p25":{"type":"number"},"p50":{"type":"number"},"p75":{"type":"number"},"p90":{"type":"number"}},"additionalProperties":false,"required":["date_mmdd","mean","p10","p25","p50","p75","p90"]}},"date_mmdd":{"type":["string","null"]},"note":{"type":["string","null"]}},"additionalProperties":false,"required":["station_id","parameter","percentiles"]},"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/get_hydro_percentiles/schema","operation":"https://allemannsdata.com/wiki/api/v1/kilder/nve/get_hydro_percentiles","source":"https://allemannsdata.com/wiki/api/v1/kilder/nve","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"},"output_fields":["station_id","parameter","percentiles","percentiles[].date_mmdd","percentiles[].mean","percentiles[].p10","percentiles[].p25","percentiles[].p50","percentiles[].p75","percentiles[].p90","date_mmdd","note"],"output_fields_truncated":false,"canonical_field_aliases":{},"response_example":{"source":"nve","operation":"get_hydro_percentiles","parameters":{"station_id":"example-id","parameter":1,"date":"2026-01-15"},"data":{"station_id":"example-id","parameter":1,"percentiles":[{"date_mmdd":"example value","mean":1.0,"p10":1.0,"p25":1.0,"p50":1.0,"p75":1.0,"p90":1.0}],"date_mmdd":"example value","note":"example value"},"entities":[{"type":"hydrology_station","id":"example-id","source":"nve","description":"Hydrology station used as the operation input."}],"_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/get_hydro_percentiles","source":"https://allemannsdata.com/wiki/api/v1/kilder/nve","wiki":"https://allemannsdata.com/wiki/kilder/nve/get_hydro_percentiles/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}}