For Agents
Query Dutch surface water body geometry as lines and polygons for Water Framework Directive compliance. Access nationwide RWS-managed water features.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Oppervlaktewaterlichamen, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Oppervlaktewaterlichamen API.
Retrieve surface water body polygons (vlakken) for area-based spatial analysis
Access surface water body lines (lijnen) for linear water feature mapping
Query individual water body features by ID for detailed geometry
List all surface water bodies compiled from RWS district data
GET STARTED
Use for: I need to find surface water body boundaries in the Netherlands, Get the polygon geometry for a specific Dutch water body, List all surface water features as line geometries, Retrieve Water Framework Directive water body spatial data
Not supported: Does not handle groundwater, marine habitats, or topographic mapping — use for official WFD surface water body geometry in the Netherlands only.
Jentic publishes the only available OpenAPI document for Oppervlaktewaterlichamen, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Oppervlaktewaterlichamen, keeping it validated and agent-ready. This PDOK API provides nationwide spatial data for surface water bodies managed by Rijkswaterstaat (RWS), the Dutch national water authority. The dataset represents the spatial foundation for the EU Water Framework Directive (KRW) in the Netherlands, compiled from district-level data as both line and polygon features. It covers rivers, canals, lakes, and other surface water bodies with their official WFD classifications.
Provide Water Framework Directive reference geometry for Dutch water management
Patterns agents use Oppervlaktewaterlichamen API for, with concrete tasks.
★ Water Framework Directive Compliance Reporting
Access the official spatial reference dataset for surface water bodies used in EU Water Framework Directive reporting. The API provides the geometries that form the basis for water quality monitoring, ecological status assessment, and management planning across all Dutch water bodies under RWS jurisdiction.
GET /vlakken/ to retrieve all surface water body polygons for use in WFD status reporting and management area delineation
Hydrological Analysis and Modeling
Download water body line and polygon features for hydrological modeling, flood risk assessment, or water management planning. The dataset covers rivers, canals, lakes, and transitional waters with geometries suitable for GIS overlay analysis and hydraulic model input.
GET /lijnen/ to retrieve all water body line features for input into a hydrological network model
Environmental Permit Assessment
Query water body geometries to determine which classified surface water bodies are affected by proposed developments, discharge permits, or land use changes. The official RWS water body boundaries establish regulatory jurisdiction for environmental permits under Dutch water law.
GET /vlakken/{id}/ to retrieve the polygon geometry of a specific water body and check spatial overlap with a proposed development area
AI Agent Water Data Retrieval via Jentic
AI agents query Dutch surface water body data as part of environmental analysis or regulatory workflows. Through Jentic, the agent discovers water body endpoints, loads the schema, and retrieves line or polygon features without navigating Dutch-language documentation or WFS conventions.
Search Jentic for 'Dutch surface water body data', load the /vlakken/ schema, and execute to retrieve water body polygons for spatial analysis
4 endpoints — jentic publishes the only available openapi specification for oppervlaktewaterlichamen, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/vlakken/
List all surface water body polygon features
/vlakken/{id}/
Retrieve a specific water body polygon by ID
/lijnen/
List all surface water body line features
/lijnen/{id}/
Retrieve a specific water body line feature by ID
/vlakken/
List all surface water body polygon features
/vlakken/{id}/
Retrieve a specific water body polygon by ID
/lijnen/
List all surface water body line features
/lijnen/{id}/
Retrieve a specific water body line feature by ID
Three things that make agents converge on Jentic-routed access.
Credential isolation
This PDOK service is a public open-data API requiring no authentication. Jentic provides schema access and intent-based discovery so agents can query surface water data without navigating Dutch WFS documentation.
Intent-based discovery
Agents search by intent (e.g., 'Dutch surface water body polygons') and Jentic returns the /vlakken/ or /lijnen/ endpoints with schemas, abstracting the Dutch naming conventions and WFS structure.
Time to first call
Direct integration: 1-2 hours to discover endpoints, understand vlakken/lijnen distinction, and parse responses. Through Jentic: under 10 minutes — search by intent, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
PDOK Habitatrichtlijn WFS
Habitat distribution data for Natura 2000 areas
Use the Habitatrichtlijn WFS when you need habitat type distributions alongside water body boundaries for combined ecological assessments.
PDOK Mossel- en Oester Habitats
Marine shellfish habitat data from Wadden Sea tidal flats
Use when you need coastal shellfish habitat data alongside inland surface water body boundaries.
OpenStreetMap API
General mapping data for base layers and geographic context
Use OpenStreetMap for road networks, land use, and settlement data to contextualize water body locations.
Specific to using Oppervlaktewaterlichamen API through Jentic.
Why is there no official OpenAPI spec for the PDOK Oppervlaktewaterlichamen API?
PDOK does not publish an OpenAPI specification for this WFS service. Jentic generates and maintains this spec so that AI agents and developers can call the Oppervlaktewaterlichamen API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does this PDOK surface water API require?
No authentication is required. This is a public Dutch government open data service operated by Rijkswaterstaat. All endpoints are freely accessible without API keys or tokens.
What is the difference between vlakken and lijnen endpoints?
The /vlakken/ endpoints provide surface water bodies as polygon geometries representing areas. The /lijnen/ endpoints provide the same water bodies as line geometries representing linear features like river centerlines. Choose polygons for area analysis and lines for network modeling.
What regulatory framework does this data support?
This dataset forms the spatial foundation for the EU Water Framework Directive (Kaderrichtlijn Water, KRW) in the Netherlands. It defines the official water body boundaries used for ecological status reporting, monitoring network design, and water management planning.
How do I query water body data through Jentic?
Install with pip install jentic, search for 'Dutch surface water bodies', and Jentic returns the /vlakken/ or /lijnen/ endpoint schemas. Execute the GET call to retrieve all features or /vlakken/{id}/ for a specific water body polygon.
Which water management authority maintains this data?
Rijkswaterstaat (RWS), the Dutch national water authority, maintains this dataset. It is compiled from district-level data covering all surface water bodies under national management jurisdiction.