Transport and logistics · New Zealand
Check New Zealand transport conditions
Read current NZTA state-highway road events, Auckland or Metlink transit service alerts, Auckland ferry positions and alerts, or historical Auckland rail trip observations.
Tool ID
nz_transportRead current NZTA state-highway road events, Auckland or Metlink transit service alerts, Auckland ferry positions and alerts, or historical Auckland rail trip observations.
ServerNew Zealand
Information categoryOfficial transport and highway feeds
Credit behavior1 credit
AccessWorkspace permissions
Inputs and outputs
Published input schema
Use the discovered runtime schema for the workspace you are connected to.
nz_transport input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"dataset": {
"type": "string",
"enum": [
"road_events",
"transit_alerts",
"ferry_status",
"akl_rail_observations"
],
"description": "Choose road_events, transit_alerts, ferry_status, or akl_rail_observations."
},
"source": {
"default": "auckland",
"description": "For transit_alerts, choose Auckland Transport or Metlink. Other datasets use their fixed official source.",
"type": "string",
"enum": [
"auckland",
"metlink"
]
},
"region": {
"description": "Optional region substring for road_events, such as Wellington or Canterbury.",
"type": "string",
"maxLength": 100
},
"query": {
"description": "Optional text filter across road event type, description, location, route and comments.",
"type": "string",
"maxLength": 200
},
"route": {
"description": "Optional Auckland rail route ID substring for akl_rail_observations.",
"type": "string",
"maxLength": 100
},
"stop": {
"description": "Optional Auckland rail stop ID substring for akl_rail_observations.",
"type": "string",
"maxLength": 100
},
"date": {
"description": "Optional AklOnTrack service date (YYYY-MM-DD); omit to use the latest indexed day with observations.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"limit": {
"default": 20,
"description": "Maximum results per list, from 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"dataset",
"source",
"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 verified NZTA state-highway events, regional transit alerts and Auckland ferry positions.
- Transit alerts for Auckland Transport and Metlink require a free registered API key.
- Historical rail trip observations reflect past performance, not live departures or route navigation.
- Does not provide turn-by-turn routing, road safety advice or airport flight status.
Local intelligence. Ready to build.
Put your AI to work.
Create a free workspace and bring local business context into your AI tools.