canonical: https://jentic.com/apis/pdok.nl/pdok-mossel-en-oester-habitats

# Pdok Nl Mossel- en oester habitats

Jentic publishes the only available OpenAPI specification for Mossel- en oester habitats, keeping it validated and agent-ready. This PDOK API provides annual survey data of mussel and oyster bank areas on the tidal flats of the Dutch Wadden Sea. The dataset is collected by IMARES on behalf of the Dutch Directorate for Animal Agro-Chains and Animal Welfare, covering the extent and location of shellfish habitats. The API offers listing and individual feature retrieval for mussel and oyster habitat spatial records.

## For AI agents

Query mussel and oyster bank habitat survey data from Dutch Wadden Sea tidal flats. Retrieve spatial features for annual shellfish habitat extent monitoring.

## Scope

Does not handle terrestrial habitats, topographic data, or water body boundaries - use for mussel and oyster bank habitat survey data on Wadden Sea tidal flats only.

## Capabilities

- List all mussel and oyster habitat survey features from the Wadden Sea
- Retrieve individual habitat features by ID with spatial geometry
- Access annual habitat extent data for shellfish population monitoring
- Query tidal flat habitat polygons for marine conservation analysis

## Use cases

### Marine Habitat Monitoring

Track the annual extent and location of mussel and oyster banks on Wadden Sea tidal flats. The API provides spatial polygons from IMARES survey campaigns, enabling year-over-year comparison of shellfish habitat coverage for conservation status reporting under Dutch fisheries management obligations.

Example prompt: GET /mosselenoesterhabitats to retrieve all mussel and oyster habitat features and compare spatial extents with previous survey data

### Fisheries Impact Assessment

Access shellfish habitat spatial data to assess the impact of fishing activities on mussel and oyster banks. The dataset supports regulatory decision-making around dredging permits, mussel seed collection, and oyster bed protection by providing the official habitat boundaries.

Example prompt: GET /mosselenoesterhabitats to retrieve habitat polygons and overlay with proposed fishing zones to identify conflicts

### Ecological Research Data Access

Download mussel and oyster habitat features for ecological research on intertidal communities, biogenic reef formation, and climate change impacts on shellfish populations. Each feature includes spatial geometry and survey metadata suitable for GIS analysis and spatial statistics.

Example prompt: GET `/mosselenoesterhabitats/{id}` to retrieve a specific habitat feature with full geometry for import into a GIS research project

### AI Agent Marine Data Retrieval via Jentic

AI agents query Dutch marine habitat data as part of environmental analysis or regulatory compliance workflows. Through Jentic, the agent discovers the mussel and oyster habitat endpoints, loads the schema, and retrieves spatial features without understanding PDOK's Dutch-language service structure.

Example prompt: Search Jentic for 'mussel oyster habitat Wadden Sea', load the /mosselenoesterhabitats schema, and execute to retrieve habitat survey features

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/mosselenoesterhabitats` | List all mussel and oyster habitat features |
| GET | `/mosselenoesterhabitats/{id}` | Retrieve a specific habitat feature by ID |

## Key resources

- **Mossel en Oester Habitats** — List and retrieve mussel and oyster bank habitat features with spatial geometry

## Why Jentic

- **Setup:** Wiring this PDOK mussel and oyster habitat service by hand means learning its Dutch endpoint naming and query structure yourself, even though it is open and needs no key. Through Jentic you install once, import the Mossel- en oester habitats service from the API Directory, and your agent calls it with no credential to manage.
- **Permission scoping:** This service carries the feature id in the URL path (`/mosselenoesterhabitats/{id}`), so a rule can pin your agent to reading habitat survey features and nothing else. The operations here are read-only queries, and you choose which ones the agent may call so only those run.
- **Credential handling:** This PDOK service is public open data and needs no authentication, so there is no credential to store; Jentic handles schema access and intent-based discovery at execution time.
- **Discovery method:** Agents search Jentic by intent such as 'mussel habitat data for the Wadden Sea', and Jentic returns the /mosselenoesterhabitats operation with its input schema so the agent calls the right endpoint without browsing the Dutch-language PDOK docs.

## Related APIs

- **PDOK Habitatrichtlijn WFS** — Terrestrial habitat distribution data under the EU Habitats Directive
- **PDOK Oppervlaktewaterlichamen** — Dutch surface water body spatial data for Water Framework Directive
- **OpenStreetMap API** — General mapping data for base layers and context

## FAQ

### Why is there no official OpenAPI spec for the PDOK Mussel and Oyster Habitats API?

PDOK does not publish an OpenAPI specification for this service. Jentic generates and maintains this spec so that AI agents and developers can call the Mossel- en oester habitats API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the PDOK Mussel and Oyster Habitats API require?

No authentication is required. This is a public Dutch government open data service. All endpoints are freely accessible without API keys or tokens.

### What geographic area does this dataset cover?

The dataset covers mussel and oyster bank habitats on the tidal flats (droogvallende platen) of the Dutch Wadden Sea. Surveys are conducted annually by IMARES to map the extent of shellfish populations.

### How often is the habitat data updated?

The survey is conducted annually by IMARES on behalf of the Dutch Directorate for Animal Agro-Chains and Animal Welfare. Each survey produces a new dataset of habitat extent features for that year.

### How do I retrieve mussel habitat data through Jentic?

Install with pip install jentic, search for 'mussel oyster habitat Wadden Sea', and Jentic returns the /mosselenoesterhabitats endpoint schema. Execute the GET call to retrieve all habitat features with spatial geometry. No authentication setup is required.

### Can I retrieve individual habitat features by ID?

Yes. GET `/mosselenoesterhabitats/{id}` retrieves a single habitat feature by its unique identifier, returning the full spatial geometry and survey attributes for that specific mussel or oyster bank record.

### Can I limit what my agent is allowed to do with the PDOK Mussel and Oyster Habitats API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use, and every operation on this service is a read-only query, so the agent can only fetch habitat survey data and never write to it. You choose whether it may list all features with GET /mosselenoesterhabitats, retrieve a single feature by its path identifier with GET `/mosselenoesterhabitats/{id}`, or both, and only the operations you allow will run. Since this is public open data with no authentication, there is no credential for the agent to hold or misuse.
