Environmental safety · New Zealand
Read New Zealand water quality and supply registers
Preview: Check New Zealand coastal swim safety alerts, river freshwater quality parameters, and official registered drinking-water supplies.
Tool ID
nz_water_qualityPreview: Check New Zealand coastal swim safety alerts, river freshwater quality parameters, and official registered drinking-water supplies.
ServerNew Zealand
Information categoryPublic environmental safety and water quality registers
Credit behaviorFree
AccessWorkspace permissions
Inputs and outputs
Published input schema
Use the discovered runtime schema for the workspace you are connected to.
nz_water_quality input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"dataset": {
"type": "string",
"enum": [
"coastal_swim_quality",
"freshwater_quality",
"drinking_water_supplies"
],
"description": "Choose coastal_swim_quality for coastal swim quality and swimming condition alerts; freshwater_quality for regional river and lake water quality monitoring indicators; drinking_water_supplies for official registered drinking-water supplies."
},
"location": {
"description": "Beach or coastal swimming spot name or slug for coastal_swim_quality (e.g. Takapuna, Mission Bay, Piha).",
"type": "string",
"maxLength": 100
},
"search": {
"description": "Text query across coastal swimming spots or freshwater sites.",
"type": "string",
"maxLength": 100
},
"region": {
"description": "Regional identifier for freshwater_quality, as one of: northland, auckland, waikato, bay-of-plenty, gisborne, hawkes-bay, taranaki, manawatu-whanganui, wellington, tasman, nelson, marlborough, west-coast, canterbury, otago, southland. Not supported for drinking_water_supplies.",
"type": "string",
"maxLength": 100
},
"site_name": {
"description": "Freshwater monitoring site name or identifier (e.g. Awanui or regional site code).",
"type": "string",
"maxLength": 150
},
"parameter": {
"description": "Freshwater indicator parameter: ECOLI (bacteria), MCI (macroinvertebrates), TON (nitrogen), NH4N (ammonia), DRP (phosphorus), CLAR (clarity), or any.",
"default": "any",
"type": "string",
"enum": [
"ECOLI",
"MCI",
"QMCI",
"TN",
"TP",
"TON",
"DRP",
"NH4",
"NO3-N",
"DIN",
"TURBFNU",
"EC",
"PH",
"CL",
"any"
]
},
"min_risk": {
"description": "Minimum alert risk level for coastal_swim_quality: GREEN, AMBER, RED, RED+, or BLACK.",
"type": "string",
"enum": [
"GREEN",
"AMBER",
"RED",
"RED+",
"BLACK"
]
},
"query": {
"description": "Search text for drinking-water supply name, supplier, or community (e.g. Akaroa).",
"type": "string",
"maxLength": 100
},
"supply_id": {
"description": "Official drinking-water supply identifier (e.g. AKA001).",
"type": "string",
"maxLength": 50
},
"limit": {
"default": 20,
"description": "Maximum results to return (1–50, default 20).",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"dataset",
"limit"
],
"additionalProperties": false
}Published output shape
Tool results return structured data or a stable error object.
Shared Aroai tool output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"summary": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"executionId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"creditsCharged": {
"type": "number",
"minimum": 0
},
"usage": {
"type": "object",
"properties": {
"credits_charged": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"credits_remaining": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"credits_charged"
],
"additionalProperties": false
}
},
"required": [
"summary",
"data",
"creditsCharged"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"additionalProperties": false
},
"usage": {
"type": "object",
"properties": {
"credits_charged": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"credits_remaining": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"credits_charged"
],
"additionalProperties": false
}
},
"required": [
"error"
],
"additionalProperties": false
}
]
}Source and usage notes
Understand the result boundary
- Covers coastal swim quality alerts and swimming conditions for monitored beaches.
- Freshwater river and lake indicators cover regional monitoring across New Zealand.
- Drinking-water supplies check registered community suppliers; registration does not verify water potability on a given day.
- Free source; does not consume credits.
Local intelligence. Ready to build.
Put your AI to work.
Create a free workspace and bring local business context into your AI tools.