GeoNet

App · 14 actions

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.

Actions

ActionWhat it does
Get a monitoring stationGet 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.
Get a quakeGet 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.
Get a quake's location historyList 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.
Get a volcano's alert levelGet 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.
Get earthquake statisticsCount 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.
Get felt reportsGet what people reported feeling through GeoNet's felt reports: around one quake, or across the last hour when no quake is given.
Get shaking measured in the last hourGet 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.
Get strong-motion readings for a quakeGet the peak ground acceleration and velocity each strong-motion station recorded for one quake, strongest first, with each station's distance from the epicentre.
List monitoring stationsList 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.
List newsList 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.
List quakes near a volcanoList 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.
List recent quakesList 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.
List volcanic alert levelsList 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.
Search earthquakesSearch GeoNet's whole earthquake catalogue, back to the 1800s, by time window, magnitude, depth, and distance from a point.

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 codestationtextRequired
The station's code, as 'List monitoring stations' returns it.
Sensor typesensor_typetextRequired
The kind of instrument, such as a broadband seismometer, a strong motion sensor or a coastal sea level gauge.

Outputs

codetext
The station's code
endtext
When it closed, in UTC; empty while open
equipment_countnumber
How many instruments have been installed
latitudenumber
The station's latitude
longitudenumber
The station's longitude
nametext
The station's name
networktext
The network it belongs to
operatingtrue/false
True while it is open
sensor_typetext
The kind of sensor that was asked for
siteslist
The sensor sites at the station
starttext
When the station opened, in UTC
Example output
{
  "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 IDquake_idtextRequired
The quake's GeoNet ID, such as 2026p553250, or a link to its page on geonet.org.nz.

Outputs

depth_kmnumber
How deep it was, in kilometres
intensitytext
That shaking in GeoNet's words: unnoticeable, weak, light, moderate, strong, severe or extreme
latitudenumber
The epicentre's latitude
localitytext
Where it was, relative to the nearest locality
longitudenumber
The epicentre's longitude
magnitudenumber
Its magnitude, to one decimal place
mminumber
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_idtext
GeoNet's public ID for the quake, such as 2026p553250
qualitytext
How settled the location is: automatic, preliminary, best, or deleted when it turned out not to be a quake
timetext
When it struck, as an ISO 8601 time in UTC
time_nztext
When it struck, in New Zealand time with its offset
urltext
The quake's page on geonet.org.nz
Example output
{
  "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 IDquake_idtextRequired
The quake's GeoNet ID, such as 2026p553250.
How many to returnlimitnumber
The most solutions to return. Defaults to 50.From 1 to 500. Default: 50.

Outputs

countnumber
How many solutions are in this result
first_magnitudenumber
The magnitude GeoNet first published
latest_magnitudenumber
The magnitude GeoNet published last
localitytext
Where the quake is placed now
magnitude_changenumber
How far the magnitude moved between those two
quake_idtext
The quake whose history this is
solutionslist
Each published solution, newest first
total_solutionsnumber
How many solutions GeoNet published
Example output
{
  "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

VolcanovolcanotextRequired
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

activitytext
GeoNet's description of its current activity
aviation_colour_codetext
Its aviation colour code: Green, Yellow, Orange or Red
has_unresttrue/false
True at level 1 or more
hazardstext
The hazards GeoNet considers most likely
is_eruptingtrue/false
True at level 3 or more
latitudenumber
The volcano's latitude
levelnumber
Its Volcanic Alert Level, from 0 (no unrest) to 5 (major eruption)
longitudenumber
The volcano's longitude
nametext
The volcano's name
urltext
The volcano's page on geonet.org.nz
volcano_idtext
GeoNet's ID for the volcano, such as ruapehu
Example output
{
  "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 countsdaysnumber
How many recent days to count day by day, newest first. Defaults to 28.From 1 to 365. Default: 28.

Outputs

average_per_daynumber
The average a day over those days
busiest_daytext
The busiest of those days
busiest_day_countnumber
Quakes on that day
by_magnitudelist
Counts per magnitude band, largest band first
daily_countslist
Quakes per day, newest first; today's count is still growing
daysnumber
How many days the daily counts cover
last_28_daysnumber
Quakes GeoNet located in the last 28 days
last_365_daysnumber
Quakes GeoNet located in the last 365 days
last_7_daysnumber
Quakes GeoNet located in the last 7 days
Example output
{
  "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 IDquake_idtext
The quake's GeoNet ID. Leave it empty for the reports made in the last hour.
Combine each area's reports byaggregationtext
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 returnlimitnumber
The most areas to return. Defaults to 25.From 1 to 1000. Default: 25.

Outputs

aggregationtext
How each area's reports were combined: max or median
location_countnumber
How many areas they came from
locationslist
The areas reports came from, strongest shaking first
max_intensitytext
That shaking in GeoNet's words
max_mminumber
The strongest shaking reported
mmi_countslist
Reports per intensity, strongest first
quake_idtext
The quake the reports are for; empty for the last hour's reports
report_countnumber
How many felt reports there were
windowtext
Which reports were read, in words
Example output
{
  "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 returnlimitnumber
The most sensors to return. Defaults to 20.From 1 to 1000. Default: 20.

Outputs

max_intensitytext
That shaking in GeoNet's words
max_mminumber
The strongest shaking measured
mmi_countslist
Sensors per intensity, strongest first
sensor_countnumber
How many sensors measured shaking
strongestlist
The sensors that shook hardest, first
Example output
{
  "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 IDquake_idtextRequired
The quake's GeoNet ID, such as 2026p553250.
How many to returnlimitnumber
The most stations to return. Defaults to 25.From 1 to 1000. Default: 25.

Outputs

availabletrue/false
False when GeoNet has processed no strong-motion data for the quake, which is usual for small ones
depth_kmnumber
The quake's depth, in kilometres
localitytext
Where the quake was
magnitudenumber
The quake's magnitude
max_mminumber
The highest intensity measured
max_pganumber
The largest horizontal acceleration recorded, in % of g
max_pgvnumber
The largest horizontal velocity recorded, in cm/s
quake_idtext
The quake the readings are for
station_countnumber
How many stations recorded it
stationslist
The stations, strongest acceleration first
Example output
{
  "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 typesensor_typetextRequired
The kind of instrument, such as a broadband seismometer, a strong motion sensor or a coastal sea level gauge.
Only stations still recordingoperating_onlytrue/false
On by default. Turn it off to include sensors that have been removed.Default: true.
Name or code containsname_containstext
Only stations whose name or code contains this text.
How many to returnlimitnumber
The most stations to return. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

countnumber
How many are in this result
sensor_typetext
The kind of sensor that was asked for
stationslist
The stations, in order of their code
total_matchingnumber
How many matched before the limit was applied
Example output
{
  "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 storykindslist
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 returnlimitnumber
The most stories to return. Defaults to 10.From 1 to 50. Default: 10.

Outputs

countnumber
How many stories are in this result
storieslist
The stories, newest first
total_availablenumber
How many stories GeoNet publishes in all
Example output
{
  "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

VolcanovolcanotextRequired
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 magnitudemin_magnitudenumber
Only quakes of at least this magnitude. Most quakes under volcanoes are below magnitude 2.From 0 to 10.
How many to returnlimitnumber
The most quakes to return. Defaults to 25.From 1 to 500. Default: 25.

Outputs

countnumber
How many quakes are in this result
largest_magnitudenumber
The largest magnitude among the matches
quakeslist
The quakes, newest first
total_matchingnumber
How many matched before the limit was applied
volcano_idtext
The volcano the quakes are near
volcano_nametext
That volcano's name
Example output
{
  "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 shakingmin_mmitext
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 magnitudemin_magnitudenumber
Only quakes of at least this magnitude, such as 4. Leave it empty for any magnitude.From 0 to 10.
How many to returnlimitnumber
The most quakes to return. Defaults to 20.From 1 to 100. Default: 20.

Outputs

countnumber
How many quakes are in this result
min_intensitytext
That minimum in GeoNet's words
min_magnitudenumber
The minimum magnitude that was asked for
min_mminumber
The minimum intensity that was asked for
quakeslist
The quakes that matched, newest first
total_matchingnumber
How many matched before the limit was applied
Example output
{
  "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 levelmin_leveltext
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

countnumber
How many volcanoes are in this result
highest_levelnumber
The highest alert level among them
volcanoeslist
The volcanoes, highest alert level first
volcanoes_with_unrestlist
The names of those at level 1 or more
Example output
{
  "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

Fromstart_timedate and time
The start of the window. Defaults to 7 days before its end.
Toend_timedate and time
The end of the window. Defaults to now.
Minimum magnitudemin_magnitudenumber
Only quakes of at least this magnitude.From 0 to 10.
Maximum magnitudemax_magnitudenumber
Only quakes of at most this magnitude.From 0 to 10.
Minimum depth (km)min_depth_kmnumber
Only quakes at least this deep, in kilometres.From 0 to 800.
Maximum depth (km)max_depth_kmnumber
Only quakes at most this deep, in kilometres.From 0 to 800.
Near latitudelatitudenumber
With a longitude, search around this point, such as -41.29 for Wellington.From -90 to 90.
Near longitudelongitudenumber
With a latitude, search around this point, such as 174.78 for Wellington.From -180 to 180.
Within (km)radius_kmnumber
How far from that point to search, in kilometres. Defaults to 100 when a point is given.From 1 to 20000.
Kinds of eventevent_typeslist
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"].
Orderordertext
Newest first by default.One of: newest (Newest first), oldest (Oldest first), largest (Largest first), smallest (Smallest first). Default: newest.
How many to returnlimitnumber
The most quakes to return. Defaults to 100.From 1 to 1000. Default: 100.

Outputs

countnumber
How many events are in this result
end_timetext
The end of the window searched, in UTC
largest_magnitudenumber
The largest magnitude among the matches
ordertext
The order the events are in
quakeslist
The events that matched, in the order asked
start_timetext
The start of the window searched, in UTC
total_matchingnumber
How many matched before the limit was applied
Example output
{
  "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
}

On this page