query: Query earthquake events

API: earthscope.org:earthscopeiris-seismic-web-services
Endpoint: /event/1/query
Response format: text/plain
Auth: unknown
Method: GET
Last Status: 406
Latency: 1189ms

Description

Returns earthquake event metadata including origin time, location (latitude/longitude/depth), magnitude, and event identifiers. Use this to discover seismic events matching specific criteria for further analysis or to correlate with other datasets.

From spec: Search for earthquake events by time, location, magnitude, and other criteria. Returns event metadata in XML or text format.

Usage Tips

- Time parameters use ISO 8601 format (YYYY-MM-DDTHH:MM:SS) - Supports min/max magnitude filtering - Can filter by geographic bounding box (minlat/maxlat/minlon/maxlon) - Response formats: text (default), xml (QuakeML), json - Large queries may timeout; use smaller time ranges or geographic constraints

Parameters (28)

catalog (string, query, optional, default: NEIC+PDE)

Specify the catalog from which origins and magnitudes will be retrieved

contributor (string, query, optional)

Limit to events contributed by a specified contributor

endtime (string, query, optional)

Limit to events/stations/data on or before the specified end time (ISO 8601 format)

eventid (string, query, optional)

Retrieve an event based on the unique ID numbers assigned by the IRIS DMC

format (string, query, optional, default: xml)

Output format for event data

Constraints: {'enum': ['xml', 'text']}

includeallmagnitudes (boolean, query, optional, default: False)

Retrieve all magnitudes for the event

includeallorigins (boolean, query, optional, default: False)

Retrieve all origins associated with each event

includearrivals (boolean, query, optional, default: False)

Specify if phase arrivals should be included

latitude (number, query, optional, default: 0)

Central latitude point for radial search (degrees)

Constraints: {'minimum': -90, 'maximum': 90}

limit (integer, query, optional)

Limit the results to the specified number of events/stations (0 or negative for unlimited)

longitude (number, query, optional, default: 0)

Central longitude point for radial search (degrees)

Constraints: {'minimum': -180, 'maximum': 180}

magnitudetype (string, query, optional)

Type of magnitude used to test minimum and maximum limits (case insensitive)

maxdepth (number, query, optional)

Limit to events with depths equal to or less than the specified depth (km)

maxlatitude (number, query, optional, default: 90.0)

Northern boundary for rectangular search (degrees)

Constraints: {'minimum': -90, 'maximum': 90}

maxlongitude (number, query, optional, default: 180.0)

Eastern boundary for rectangular search (degrees)

Constraints: {'minimum': -180, 'maximum': 180}

maxmagnitude (number, query, optional)

Limit to events with magnitude smaller than or equal to the specified maximum

maxradius (number, query, optional, default: 180)

Maximum distance from the geographic point (degrees)

Constraints: {'minimum': 0, 'maximum': 180}

mindepth (number, query, optional)

Limit to events with depths equal to or greater than the specified depth (km)

minlatitude (number, query, optional, default: -90.0)

Southern boundary for rectangular search (degrees)

Constraints: {'minimum': -90, 'maximum': 90}

minlongitude (number, query, optional, default: -180.0)

Western boundary for rectangular search (degrees)

Constraints: {'minimum': -180, 'maximum': 180}

minmagnitude (number, query, optional)

Limit to events with magnitude larger than or equal to the specified minimum

minradius (number, query, optional, default: 0)

Minimum distance from the geographic point (degrees)

Constraints: {'minimum': 0, 'maximum': 180}

nodata (integer, query, optional, default: 204)

Specify which HTTP status code is returned when no data is found

Constraints: {'enum': [204, 404]}

offset (integer, query, optional, default: 1)

Return results starting at the event count specified

orderby (string, query, optional, default: time)

Specify the ordering of the returned results

Constraints: {'enum': ['time', 'magnitude', 'time-asc', 'magnitude-asc']}

originid (string, query, optional)

Retrieve an event based on the unique origin ID numbers assigned by the IRIS DMC

starttime (string, query, optional)

Limit to events/stations/data on or after the specified start time (ISO 8601 format)

updatedafter (string, query, optional)

Limit to events/stations updated after the specified time

Examples (1)

Query large earthquakes in January 2024 doc_extracted

Demonstrates querying earthquake events by time range and minimum magnitude, returning results in text format

curl 'https://service.earthscope.org/fdsnws/event/1/query?starttime=2024-01-01&endtime=2024-01-31&minmagnitude=6.0&format=text'

import requests

resp = requests.get(
    "https://service.earthscope.org/fdsnws/event/1/query",
    params={
        'starttime': '2024-01-01',
        'endtime': '2024-01-31',
        'minmagnitude': '6.0',
        'format': 'text',
    },
)
data = resp.json()

import zingu_apis

api = zingu_apis.api("earthscope")
result = api.fetch("event/1/query", starttime="2024-01-01", endtime="2024-01-31", minmagnitude=6.0, format="text")

for item in result:
    print(item)

const resp = await fetch("https://service.earthscope.org/fdsnws/event/1/query?starttime=2024-01-01&endtime=2024-01-31&minmagnitude=6.0&format=text");
const data = await resp.json();

Truncate

Auto Table Raw

Probe History

Latency

Status Codes

Time	Status	Latency
2026-04-16 03:27:26.493534	406	1189ms
2026-04-15 02:01:37.474966	406	1108ms
2026-04-14 01:01:46.166132	406	1316ms
2026-04-12 13:42:03.974967	406	1668ms