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
| Action | What it does |
|---|---|
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| Search earthquakes | Search 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 code
stationtextRequired - The station's code, as 'List monitoring stations' returns it.
- Sensor type
sensor_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 ID
quake_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 ID
quake_idtextRequired - The quake's GeoNet ID, such as 2026p553250.
- How many to return
limitnumber - 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
- Volcano
volcanotextRequired - 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 counts
daysnumber - 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 ID
quake_idtext - The quake's GeoNet ID. Leave it empty for the reports made in the last hour.
- Combine each area's reports by
aggregationtext - 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
limitnumber - 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 return
limitnumber - 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 ID
quake_idtextRequired - The quake's GeoNet ID, such as 2026p553250.
- How many to return
limitnumber - 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 type
sensor_typetextRequired - The kind of instrument, such as a broadband seismometer, a strong motion sensor or a coastal sea level gauge.
- Only stations still recording
operating_onlytrue/false - On by default. Turn it off to include sensors that have been removed.Default:
true. - Name or code contains
name_containstext - Only stations whose name or code contains this text.
- How many to return
limitnumber - 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 story
kindslist - 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
limitnumber - 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
- Volcano
volcanotextRequired - 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_magnitudenumber - Only quakes of at least this magnitude. Most quakes under volcanoes are below magnitude 2.From 0 to 10.
- How many to return
limitnumber - 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 shaking
min_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 magnitude
min_magnitudenumber - Only quakes of at least this magnitude, such as 4. Leave it empty for any magnitude.From 0 to 10.
- How many to return
limitnumber - 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 level
min_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
- From
start_timedate and time - The start of the window. Defaults to 7 days before its end.
- To
end_timedate and time - The end of the window. Defaults to now.
- Minimum magnitude
min_magnitudenumber - Only quakes of at least this magnitude.From 0 to 10.
- Maximum magnitude
max_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 latitude
latitudenumber - With a longitude, search around this point, such as -41.29 for Wellington.From -90 to 90.
- Near longitude
longitudenumber - 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 event
event_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"]. - Order
ordertext - Newest first by default.One of:
newest(Newest first),oldest(Oldest first),largest(Largest first),smallest(Smallest first). Default:newest. - How many to return
limitnumber - 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
}