Tools (4)

get_county_overview
get_region_details
get_flood_warnings
report_feedback

get_county_overview

Get current flood warning levels for all Norwegian counties.

Returns a summary of flood risk across Norway with activity levels
(1=green/safe, 2=yellow/moderate, 3=orange/significant, 4=red/extreme).
Use this to quickly check if any part of Norway has elevated flood risk.

Returns:
County list with activity levels, plus count of counties with elevated warnings.

Request Body

{
  "query": "example"
}

get_region_details

Get municipalities and active warnings for a Norwegian county.

Drill down into a specific county to see which municipalities are affected
and what warnings are active.

Returns:
Region details with municipality list and any active warnings.

Parameter	Type	Required	Description
`county_id`	`string`	required	Norwegian county ID (e.g. '03' for Oslo, '46' for Vestland, '50' for Trøndelag).

Request Body

{
  "county_id": "example"
}

get_flood_warnings

Get flood warnings for Norway, optionally filtered by county or municipality.

Returns detailed flood warnings from the Norwegian Water Resources and Energy
Directorate (NVE). Warnings include activity level, affected areas, and
descriptive text explaining the flood risk.

Activity levels: 1=green (safe), 2=yellow (moderate), 3=orange (significant), 4=red (extreme).

Returns:
List of flood warnings with severity, affected areas, and validity period.

Parameter	Type	Required	Description
`county_id`	`any`	optional	Filter by county ID (e.g. '46' for Vestland). Omit for all of Norway.
`municipality_id`	`any`	optional	Filter by municipality ID (e.g. '0301' for Oslo). Overrides county_id if set.
`start_date`	`any`	optional	Start date in YYYY-MM-DD format. Defaults to today.
`end_date`	`any`	optional	End date in YYYY-MM-DD format. Defaults to 3 days from today.

Request Body

{
  "query": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/nve-flood/get_region_details" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"county_id": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/nve-flood/get_region_details",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "county_id": "example"
},
)
print(resp.json())