# GeoNet

> Track earthquakes and volcanoes in New Zealand from a workflow, with data from GeoNet. List the quakes that may have been felt, look one up with its location history, search the whole catalogue by time, magnitude, depth and place, and count quakes by week, month and year. See what people felt and what sensors measured, and the strong-motion readings for a quake. Check every volcano's alert level and the quakes beneath it, read GeoNet's bulletins, and look up its monitoring stations. Start a workflow when a new quake strikes or a volcano's alert level changes. No account or API key required.

App · 14 actions. Web page: https://docs.lodol.com/docs/integrations/geonet

## Actions

### Get a monitoring station

Get one GeoNet station's details for a kind of sensor: where it is, when it opened, and every instrument installed at each of its sites, with make, model and the data channels recorded.

**Inputs**

- Station code (`station`, text, required): The station's code, as 'List monitoring stations' returns it.
- Sensor type (`sensor_type`, text, required): The kind of instrument, such as a broadband seismometer, a strong motion sensor or a coastal sea level gauge.

**Outputs**

- `code` (text): The station's code
- `end` (text): When it closed, in UTC; empty while open
- `equipment_count` (number): How many instruments have been installed
- `latitude` (number): The station's latitude
- `longitude` (number): The station's longitude
- `name` (text): The station's name
- `network` (text): The network it belongs to
- `operating` (true/false): True while it is open
- `sensor_type` (text): The kind of sensor that was asked for
- `sites` (list): The sensor sites at the station
- `start` (text): When the station opened, in UTC

**Example output**

```json
{
  "code": "WEL",
  "end": "",
  "equipment_count": 1,
  "latitude": -41.284,
  "longitude": 174.7682,
  "name": "Wellington",
  "network": "NZ",
  "operating": true,
  "sensor_type": "Broadband seismometer",
  "sites": [
    {
      "elevation_m": 138.0,
      "end": "",
      "equipment": [
        {
          "channels": "HHE,HHN,HHZ,LHE,LHN,LHZ",
          "end": "",
          "make": "Guralp",
          "model": "CMG-3ESP",
          "operating": true,
          "start": "2023-12-06T23:03:00Z",
          "type": "Broadband Seismometer"
        }
      ],
      "latitude": -41.284,
      "location": "10",
      "longitude": 174.7682,
      "operating": true,
      "start": "1987-08-18T10:48:00Z"
    }
  ],
  "start": "1916-01-01T00:00:00Z"
}
```

### Get a quake

Get one quake by its GeoNet ID: when it struck, its magnitude, depth and location, the shaking it may have caused, and how settled GeoNet's solution is. Use it to read a quake again after GeoNet has reviewed it, since magnitudes change in the first hours.

**Inputs**

- Quake ID (`quake_id`, text, required): The quake's GeoNet ID, such as 2026p553250, or a link to its page on geonet.org.nz.

**Outputs**

- `depth_km` (number): How deep it was, in kilometres
- `intensity` (text): That shaking in GeoNet's words: unnoticeable, weak, light, moderate, strong, severe or extreme
- `latitude` (number): The epicentre's latitude
- `locality` (text): Where it was, relative to the nearest locality
- `longitude` (number): The epicentre's longitude
- `magnitude` (number): Its magnitude, to one decimal place
- `mmi` (number): The shaking it may have caused at the nearest New Zealand locality, on the Modified Mercalli Intensity scale; -1 when too small to rate
- `quake_id` (text): GeoNet's public ID for the quake, such as 2026p553250
- `quality` (text): How settled the location is: automatic, preliminary, best, or deleted when it turned out not to be a quake
- `time` (text): When it struck, as an ISO 8601 time in UTC
- `time_nz` (text): When it struck, in New Zealand time with its offset
- `url` (text): The quake's page on geonet.org.nz

**Example output**

```json
{
  "depth_km": 9.3,
  "intensity": "severe",
  "latitude": -38.9656,
  "locality": "5 km south of Taumarunui",
  "longitude": 175.2372,
  "magnitude": 5.9,
  "mmi": 7,
  "quake_id": "2026p553250",
  "quality": "best",
  "time": "2026-07-24T16:51:36Z",
  "time_nz": "2026-07-25T04:51:36+12:00",
  "url": "https://www.geonet.org.nz/earthquake/2026p553250"
}
```

### Get a quake's location history

List every solution GeoNet published for one quake, newest first, from the first automatic estimate to the reviewed one, with how far the magnitude moved between them. Not every quake has a history; one without comes back with none.

**Inputs**

- Quake ID (`quake_id`, text, required): The quake's GeoNet ID, such as 2026p553250.
- How many to return (`limit`, number): The most solutions to return. Defaults to 50. From 1 to 500. Default: `50`.

**Outputs**

- `count` (number): How many solutions are in this result
- `first_magnitude` (number): The magnitude GeoNet first published
- `latest_magnitude` (number): The magnitude GeoNet published last
- `locality` (text): Where the quake is placed now
- `magnitude_change` (number): How far the magnitude moved between those two
- `quake_id` (text): The quake whose history this is
- `solutions` (list): Each published solution, newest first
- `total_solutions` (number): How many solutions GeoNet published

**Example output**

```json
{
  "count": 2,
  "first_magnitude": 5.71,
  "latest_magnitude": 5.95,
  "locality": "5 km south of Taumarunui",
  "magnitude_change": 0.24,
  "quake_id": "2026p553250",
  "solutions": [
    {
      "depth_km": 9.3,
      "intensity": "severe",
      "latitude": -38.9656,
      "locality": "5 km south of Taumarunui",
      "longitude": 175.2372,
      "magnitude": 5.95,
      "mmi": 7,
      "modified_time": "2026-08-31T03:19:01Z",
      "quality": "best",
      "time": "2026-07-24T16:51:36Z"
    },
    {
      "depth_km": 12.0,
      "intensity": "severe",
      "latitude": -39.0012,
      "locality": "10 km south of Taumarunui",
      "longitude": 175.2201,
      "magnitude": 5.71,
      "mmi": 7,
      "modified_time": "2026-07-24T16:53:12Z",
      "quality": "automatic",
      "time": "2026-07-24T16:51:37Z"
    }
  ],
  "total_solutions": 160
}
```

### Get a volcano's alert level

Get one volcano's current Volcanic Alert Level, aviation colour code, activity and likely hazards, with plain yes or no answers to whether it shows unrest and whether it is erupting.

**Inputs**

- Volcano (`volcano`, text, required): The volcano, from the twelve GeoNet sets an alert level for. A name from an earlier step works too, such as Ruapehu or White Island.

**Outputs**

- `activity` (text): GeoNet's description of its current activity
- `aviation_colour_code` (text): Its aviation colour code: Green, Yellow, Orange or Red
- `has_unrest` (true/false): True at level 1 or more
- `hazards` (text): The hazards GeoNet considers most likely
- `is_erupting` (true/false): True at level 3 or more
- `latitude` (number): The volcano's latitude
- `level` (number): Its Volcanic Alert Level, from 0 (no unrest) to 5 (major eruption)
- `longitude` (number): The volcano's longitude
- `name` (text): The volcano's name
- `url` (text): The volcano's page on geonet.org.nz
- `volcano_id` (text): GeoNet's ID for the volcano, such as ruapehu

**Example output**

```json
{
  "activity": "Moderate to heightened volcanic unrest.",
  "aviation_colour_code": "Yellow",
  "has_unrest": true,
  "hazards": "Volcanic unrest hazards, potential for eruption hazards.",
  "is_erupting": false,
  "latitude": -37.521,
  "level": 2,
  "longitude": 177.183,
  "name": "White Island",
  "url": "https://www.geonet.org.nz/volcano/whiteisland",
  "volcano_id": "whiteisland"
}
```

### Get earthquake statistics

Count the quakes GeoNet located in the last 7, 28 and 365 days, in total and by magnitude band, and day by day for as many recent days as you choose. Use it for a weekly summary or to notice a busy spell.

**Inputs**

- Days of daily counts (`days`, number): How many recent days to count day by day, newest first. Defaults to 28. From 1 to 365. Default: `28`.

**Outputs**

- `average_per_day` (number): The average a day over those days
- `busiest_day` (text): The busiest of those days
- `busiest_day_count` (number): Quakes on that day
- `by_magnitude` (list): Counts per magnitude band, largest band first
- `daily_counts` (list): Quakes per day, newest first; today's count is still growing
- `days` (number): How many days the daily counts cover
- `last_28_days` (number): Quakes GeoNet located in the last 28 days
- `last_365_days` (number): Quakes GeoNet located in the last 365 days
- `last_7_days` (number): Quakes GeoNet located in the last 7 days

**Example output**

```json
{
  "average_per_day": 44.5,
  "busiest_day": "2026-10-18",
  "busiest_day_count": 52,
  "by_magnitude": [
    {
      "label": "Magnitude 5 to 5.9",
      "last_28_days": 3,
      "last_365_days": 80,
      "last_7_days": 1,
      "magnitude": 5
    },
    {
      "label": "Magnitude 4 to 4.9",
      "last_28_days": 41,
      "last_365_days": 580,
      "last_7_days": 9,
      "magnitude": 4
    }
  ],
  "daily_counts": [
    {
      "count": 37,
      "date": "2026-10-19"
    },
    {
      "count": 52,
      "date": "2026-10-18"
    }
  ],
  "days": 2,
  "last_28_days": 1678,
  "last_365_days": 22106,
  "last_7_days": 410
}
```

### Get felt reports

Get what people reported feeling through GeoNet's felt reports: around one quake, or across the last hour when no quake is given. Returns how many reported, the strongest shaking, a count per intensity, and the areas the reports came from, strongest first.

**Inputs**

- Quake ID (`quake_id`, text): The quake's GeoNet ID. Leave it empty for the reports made in the last hour.
- Combine each area's reports by (`aggregation`, text): Where several people reported from the same area, keep the strongest report or the typical one. One of: `max` (Strongest report in each area), `median` (Typical (median) report in each area). Default: `max`.
- How many to return (`limit`, number): The most areas to return. Defaults to 25. From 1 to 1000. Default: `25`.

**Outputs**

- `aggregation` (text): How each area's reports were combined: max or median
- `location_count` (number): How many areas they came from
- `locations` (list): The areas reports came from, strongest shaking first
- `max_intensity` (text): That shaking in GeoNet's words
- `max_mmi` (number): The strongest shaking reported
- `mmi_counts` (list): Reports per intensity, strongest first
- `quake_id` (text): The quake the reports are for; empty for the last hour's reports
- `report_count` (number): How many felt reports there were
- `window` (text): Which reports were read, in words

**Example output**

```json
{
  "aggregation": "max",
  "location_count": 5732,
  "locations": [
    {
      "intensity": "extreme",
      "latitude": -38.8936,
      "longitude": 175.2603,
      "mmi": 8,
      "reports": 12
    },
    {
      "intensity": "severe",
      "latitude": -39.0418,
      "longitude": 175.1505,
      "mmi": 7,
      "reports": 4
    }
  ],
  "max_intensity": "extreme",
  "max_mmi": 8,
  "mmi_counts": [
    {
      "count": 27,
      "intensity": "extreme",
      "mmi": 8
    },
    {
      "count": 138,
      "intensity": "severe",
      "mmi": 7
    }
  ],
  "quake_id": "2026p553250",
  "report_count": 22942,
  "window": "Reports made around quake 2026p553250"
}
```

### Get shaking measured in the last hour

Get the strongest shaking GeoNet's sensors measured across New Zealand in the last hour: how many sensors reported, the strongest intensity, a count per intensity, and the sensors that shook hardest. A quick check of whether anything is shaking right now.

**Inputs**

- How many to return (`limit`, number): The most sensors to return. Defaults to 20. From 1 to 1000. Default: `20`.

**Outputs**

- `max_intensity` (text): That shaking in GeoNet's words
- `max_mmi` (number): The strongest shaking measured
- `mmi_counts` (list): Sensors per intensity, strongest first
- `sensor_count` (number): How many sensors measured shaking
- `strongest` (list): The sensors that shook hardest, first

**Example output**

```json
{
  "max_intensity": "weak",
  "max_mmi": 3,
  "mmi_counts": [
    {
      "count": 2,
      "intensity": "weak",
      "mmi": 3
    },
    {
      "count": 323,
      "intensity": "unnoticeable",
      "mmi": 1
    }
  ],
  "sensor_count": 325,
  "strongest": [
    {
      "intensity": "weak",
      "latitude": -40.8719,
      "longitude": 175.578,
      "mmi": 3
    },
    {
      "intensity": "weak",
      "latitude": -41.3087,
      "longitude": 174.7043,
      "mmi": 3
    }
  ]
}
```

### Get strong-motion readings for a quake

Get the peak ground acceleration and velocity each strong-motion station recorded for one quake, strongest first, with each station's distance from the epicentre. Engineers use it to see how hard buildings near a site were shaken. Small quakes have no readings, and come back saying so.

**Inputs**

- Quake ID (`quake_id`, text, required): The quake's GeoNet ID, such as 2026p553250.
- How many to return (`limit`, number): The most stations to return. Defaults to 25. From 1 to 1000. Default: `25`.

**Outputs**

- `available` (true/false): False when GeoNet has processed no strong-motion data for the quake, which is usual for small ones
- `depth_km` (number): The quake's depth, in kilometres
- `locality` (text): Where the quake was
- `magnitude` (number): The quake's magnitude
- `max_mmi` (number): The highest intensity measured
- `max_pga` (number): The largest horizontal acceleration recorded, in % of g
- `max_pgv` (number): The largest horizontal velocity recorded, in cm/s
- `quake_id` (text): The quake the readings are for
- `station_count` (number): How many stations recorded it
- `stations` (list): The stations, strongest acceleration first

**Example output**

```json
{
  "available": true,
  "depth_km": 9.3,
  "locality": "5 km south of Taumarunui",
  "magnitude": 5.9,
  "max_mmi": 7,
  "max_pga": 38.1215,
  "max_pgv": 21.3804,
  "quake_id": "2026p553250",
  "station_count": 182,
  "stations": [
    {
      "distance_km": 6.4,
      "intensity": "severe",
      "latitude": -38.8847,
      "location": "20",
      "longitude": 175.2621,
      "mmi": 7,
      "name": "Taumarunui Valley School",
      "network": "SM",
      "pga_horizontal": 38.1215,
      "pga_vertical": 17.022,
      "pgv_horizontal": 21.3804,
      "pgv_vertical": 6.0131,
      "station": "TMVS"
    },
    {
      "distance_km": 263.5,
      "intensity": "weak",
      "latitude": -41.3087,
      "location": "20",
      "longitude": 174.7043,
      "mmi": 3,
      "name": "South Karori",
      "network": "IU",
      "pga_horizontal": 0.106,
      "pga_vertical": 0.0783,
      "pgv_horizontal": 0.1486,
      "pgv_vertical": 0.1204,
      "station": "SNZO"
    }
  ]
}
```

### List monitoring stations

List the GeoNet sites that carry one kind of sensor, such as seismometers, tsunami gauges, GPS stations or volcano cameras, with each site's code, name, position and when it started recording.

**Inputs**

- Sensor type (`sensor_type`, text, required): The kind of instrument, such as a broadband seismometer, a strong motion sensor or a coastal sea level gauge.
- Only stations still recording (`operating_only`, true/false): On by default. Turn it off to include sensors that have been removed. Default: `true`.
- Name or code contains (`name_contains`, text): Only stations whose name or code contains this text.
- How many to return (`limit`, number): The most stations to return. Defaults to 50. From 1 to 1000. Default: `50`.

**Outputs**

- `count` (number): How many are in this result
- `sensor_type` (text): The kind of sensor that was asked for
- `stations` (list): The stations, in order of their code
- `total_matching` (number): How many matched before the limit was applied

**Example output**

```json
{
  "count": 1,
  "sensor_type": "Coastal sea level gauge",
  "stations": [
    {
      "code": "AUCT",
      "end": "",
      "latitude": -36.8314,
      "location": "40",
      "longitude": 174.7865,
      "name": "Auckland",
      "network": "TG",
      "operating": true,
      "sensor_type": "Coastal sea level gauge",
      "start": "2009-03-26T00:00:00Z"
    }
  ],
  "total_matching": 21
}
```

### List news

List GeoNet's latest stories, newest first: volcanic activity bulletins (with the alert level each announces), stories about notable quakes and other geohazard events, news and data blog posts. Narrow to the kinds you want.

**Inputs**

- Kinds of story (`kinds`, list): Only these kinds. Leave it empty for every kind. One or more of: `vab` (Volcanic activity bulletins), `responseStory` (Geohazard events), `newsStory` (News), `dataBlog` (Data blog).
- How many to return (`limit`, number): The most stories to return. Defaults to 10. From 1 to 50. Default: `10`.

**Outputs**

- `count` (number): How many stories are in this result
- `stories` (list): The stories, newest first
- `total_available` (number): How many stories GeoNet publishes in all

**Example output**

```json
{
  "count": 2,
  "stories": [
    {
      "alert_level": 2,
      "kind": "vab",
      "kind_label": "Volcanic activity bulletin",
      "published": "2026-10-16T04:40:00Z",
      "title": "Weak ash emission at Whakaari/White Island. Volcanic Alert Level remains at 2 and Aviation Colour Code remains at Yellow.",
      "url": "https://www.geonet.org.nz/vabs/7BMc046E4el6MxFFOKOFIi"
    },
    {
      "alert_level": null,
      "kind": "newsStory",
      "kind_label": "News",
      "published": "2026-10-15T02:40:00Z",
      "title": "A fresh new look for GeoNet arrives next week",
      "url": "https://www.geonet.org.nz/news/uPPogP5xlg6L6fg5fX7Ne"
    }
  ],
  "total_available": 1296
}
```

### List quakes near a volcano

List the quakes GeoNet located in the region around one volcano over the last 60 days, newest first, with the shaking at the epicentre and whether a person has reviewed each one.

**Inputs**

- Volcano (`volcano`, text, required): The volcano, from the twelve GeoNet sets an alert level for. A name from an earlier step works too, such as Ruapehu or White Island.
- Minimum magnitude (`min_magnitude`, number): Only quakes of at least this magnitude. Most quakes under volcanoes are below magnitude 2. From 0 to 10.
- How many to return (`limit`, number): The most quakes to return. Defaults to 25. From 1 to 500. Default: `25`.

**Outputs**

- `count` (number): How many quakes are in this result
- `largest_magnitude` (number): The largest magnitude among the matches
- `quakes` (list): The quakes, newest first
- `total_matching` (number): How many matched before the limit was applied
- `volcano_id` (text): The volcano the quakes are near
- `volcano_name` (text): That volcano's name

**Example output**

```json
{
  "count": 1,
  "largest_magnitude": 0.7,
  "quakes": [
    {
      "depth_km": 15.8,
      "epicentre_intensity": "unnoticeable",
      "intensity": "unnoticeable",
      "latitude": -39.4871,
      "locality": "20 km north of Taihape",
      "longitude": 175.7346,
      "magnitude": 0.7,
      "mmi": -1,
      "quake_id": "2026p787918",
      "quality": "best",
      "status": "reviewed",
      "time": "2026-10-19T12:43:05Z",
      "time_nz": "2026-10-20T01:43:05+13:00",
      "url": "https://www.geonet.org.nz/earthquake/2026p787918"
    }
  ],
  "total_matching": 66,
  "volcano_id": "ruapehu",
  "volcano_name": "Ruapehu"
}
```

### List recent quakes

List the quakes of the last year that may have been felt in New Zealand, newest first, down to a shaking intensity you choose and optionally a magnitude. Each comes with its time in UTC and New Zealand time, magnitude, depth, locality, the shaking it may have caused, and its GeoNet ID for the other quake steps. GeoNet returns at most 100 quakes for each intensity.

**Inputs**

- Minimum shaking (`min_mmi`, text): The weakest shaking to include, on the Modified Mercalli Intensity scale at the nearest New Zealand locality. MMI 3 (weak) is roughly the level people notice; choose 'Every quake' for the last day or so of all of them. Default: `3`.
- Minimum magnitude (`min_magnitude`, number): Only quakes of at least this magnitude, such as 4. Leave it empty for any magnitude. From 0 to 10.
- How many to return (`limit`, number): The most quakes to return. Defaults to 20. From 1 to 100. Default: `20`.

**Outputs**

- `count` (number): How many quakes are in this result
- `min_intensity` (text): That minimum in GeoNet's words
- `min_magnitude` (number): The minimum magnitude that was asked for
- `min_mmi` (number): The minimum intensity that was asked for
- `quakes` (list): The quakes that matched, newest first
- `total_matching` (number): How many matched before the limit was applied

**Example output**

```json
{
  "count": 2,
  "min_intensity": "light",
  "min_magnitude": 3.0,
  "min_mmi": 4,
  "quakes": [
    {
      "depth_km": 15.8,
      "intensity": "light",
      "latitude": -40.8745,
      "locality": "5 km north-west of Masterton",
      "longitude": 175.5941,
      "magnitude": 3.1,
      "mmi": 4,
      "quake_id": "2026p788916",
      "quality": "best",
      "time": "2026-10-19T21:34:36Z",
      "time_nz": "2026-10-20T10:34:36+13:00",
      "url": "https://www.geonet.org.nz/earthquake/2026p788916"
    },
    {
      "depth_km": 9.3,
      "intensity": "severe",
      "latitude": -38.9656,
      "locality": "5 km south of Taumarunui",
      "longitude": 175.2372,
      "magnitude": 5.9,
      "mmi": 7,
      "quake_id": "2026p553250",
      "quality": "best",
      "time": "2026-07-24T16:51:36Z",
      "time_nz": "2026-07-25T04:51:36+12:00",
      "url": "https://www.geonet.org.nz/earthquake/2026p553250"
    }
  ],
  "total_matching": 100
}
```

### List volcanic alert levels

List the current Volcanic Alert Level of every volcano GeoNet watches, from 0 (no unrest) to 5 (major eruption), with its aviation colour code, activity and likely hazards, highest level first.

**Inputs**

- Minimum alert level (`min_level`, text): Only volcanoes at this level or above. Leave it empty for all of them. One of: `1` (Level 1 or more (minor unrest)), `2` (Level 2 or more (moderate to heightened unrest)), `3` (Level 3 or more (eruption)), `4` (Level 4 or more (moderate eruption)), `5` (Level 5 (major eruption)).

**Outputs**

- `count` (number): How many volcanoes are in this result
- `highest_level` (number): The highest alert level among them
- `volcanoes` (list): The volcanoes, highest alert level first
- `volcanoes_with_unrest` (list): The names of those at level 1 or more

**Example output**

```json
{
  "count": 2,
  "highest_level": 2,
  "volcanoes": [
    {
      "activity": "Moderate to heightened volcanic unrest.",
      "aviation_colour_code": "Yellow",
      "has_unrest": true,
      "hazards": "Volcanic unrest hazards, potential for eruption hazards.",
      "is_erupting": false,
      "latitude": -37.521,
      "level": 2,
      "longitude": 177.183,
      "name": "White Island",
      "url": "https://www.geonet.org.nz/volcano/whiteisland",
      "volcano_id": "whiteisland"
    },
    {
      "activity": "Minor volcanic unrest.",
      "aviation_colour_code": "Green",
      "has_unrest": true,
      "hazards": "Volcanic unrest hazards.",
      "is_erupting": false,
      "latitude": -39.281,
      "level": 1,
      "longitude": 175.563,
      "name": "Ruapehu",
      "url": "https://www.geonet.org.nz/volcano/ruapehu",
      "volcano_id": "ruapehu"
    }
  ],
  "volcanoes_with_unrest": [
    "White Island",
    "Ruapehu"
  ]
}
```

### Search earthquakes

Search GeoNet's whole earthquake catalogue, back to the 1800s, by time window, magnitude, depth, and distance from a point. Use it for anything 'List recent quakes' cannot reach: last month's quakes near Wellington, every magnitude 6 since 2010, the deep ones under Taupō. A search may match up to 10,000 events, so a long window needs a minimum magnitude.

**Inputs**

- From (`start_time`, date and time): The start of the window. Defaults to 7 days before its end.
- To (`end_time`, date and time): The end of the window. Defaults to now.
- Minimum magnitude (`min_magnitude`, number): Only quakes of at least this magnitude. From 0 to 10.
- Maximum magnitude (`max_magnitude`, number): Only quakes of at most this magnitude. From 0 to 10.
- Minimum depth (km) (`min_depth_km`, number): Only quakes at least this deep, in kilometres. From 0 to 800.
- Maximum depth (km) (`max_depth_km`, number): Only quakes at most this deep, in kilometres. From 0 to 800.
- Near latitude (`latitude`, number): With a longitude, search around this point, such as -41.29 for Wellington. From -90 to 90.
- Near longitude (`longitude`, number): With a latitude, search around this point, such as 174.78 for Wellington. From -180 to 180.
- Within (km) (`radius_km`, number): How far from that point to search, in kilometres. Defaults to 100 when a point is given. From 1 to 20000.
- Kinds of event (`event_types`, list): Which kinds of event to include. Earthquakes and volcano-tectonic earthquakes by default; add distant quakes to include large ones elsewhere in the Pacific that GeoNet also records. One or more of: `earthquake` (Earthquakes), `volcano-tectonic` (Volcano-tectonic earthquakes), `outside of network interest` (Distant quakes outside New Zealand's network), `quarry blast` (Quarry blasts), `not locatable` (Events that could not be located), `unknown` (Unknown events). Default: `["earthquake", "volcano-tectonic"]`.
- Order (`order`, text): Newest first by default. One of: `newest` (Newest first), `oldest` (Oldest first), `largest` (Largest first), `smallest` (Smallest first). Default: `newest`.
- How many to return (`limit`, number): The most quakes to return. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many events are in this result
- `end_time` (text): The end of the window searched, in UTC
- `largest_magnitude` (number): The largest magnitude among the matches
- `order` (text): The order the events are in
- `quakes` (list): The events that matched, in the order asked
- `start_time` (text): The start of the window searched, in UTC
- `total_matching` (number): How many matched before the limit was applied

**Example output**

```json
{
  "count": 2,
  "end_time": "2026-10-20T00:00:00Z",
  "largest_magnitude": 5.2,
  "order": "newest",
  "quakes": [
    {
      "depth_km": 16.0,
      "event_type": "earthquake",
      "latitude": -40.533,
      "locality": "15 km east of Pongaroa",
      "longitude": 176.401,
      "magnitude": 4.0,
      "magnitude_type": "MLv",
      "quake_id": "2026p788453",
      "time": "2026-10-19T17:27:59Z",
      "time_nz": "2026-10-20T06:27:59+13:00",
      "url": "https://www.geonet.org.nz/earthquake/2026p788453"
    },
    {
      "depth_km": 14.2,
      "event_type": "earthquake",
      "latitude": -39.15,
      "locality": "20 km north of Stratford",
      "longitude": 174.381,
      "magnitude": 5.2,
      "magnitude_type": "M",
      "quake_id": "2026p742111",
      "time": "2026-10-02T13:57:16Z",
      "time_nz": "2026-10-03T02:57:16+13:00",
      "url": "https://www.geonet.org.nz/earthquake/2026p742111"
    }
  ],
  "start_time": "2026-10-01T00:00:00Z",
  "total_matching": 2
}
```
