GET query
Summary: Query earthquake events
Operation ID: queryEvents
Auth: unknown
Operation ID: queryEvents
Auth: unknown
Description
Query earthquake events with extensive filtering options including location, magnitude, time, and more
Parameters (47)
alertlevel
(string, query, optional)
PAGER alert level
Constraints: {'enum': ['green', 'yellow', 'orange', 'red']}
callback
(string, query, optional)
JSONP callback function name
Constraints: {'pattern': '^[A-Za-z0-9\\._]+$'}
catalog
(string, query, optional)
Limit to events from specified catalog
contributor
(string, query, optional)
Limit to events from specified contributor
endtime
(string, query, optional)
Limit to events on or before specified time (ISO8601)
eventid
(string, query, optional)
Select specific event by ID
eventtype
(string, query, optional)
Limit to specific event type
format
(string, query, optional, default: quakeml)
Output format
Constraints: {'enum': ['quakeml', 'csv', 'geojson', 'kml', 'text', 'xml']}
includeallmagnitudes
(boolean, query, optional, default: False)
Include all magnitudes for event
includeallorigins
(boolean, query, optional, default: False)
Include all origins for event
includearrivals
(boolean, query, optional, default: False)
Include phase arrivals (NOT IMPLEMENTED)
includedeleted
(string, query, optional, default: false)
Include deleted events. Value 'only' returns only deleted
Constraints: {'enum': ['true', 'false', 'only']}
includesuperseded
(boolean, query, optional, default: False)
Include superseded products
jsonerror
(boolean, query, optional, default: False)
Return JSON on errors
kmlanimated
(boolean, query, optional, default: False)
Include timestamp for Google Earth animation
kmlcolorby
(string, query, optional, default: age)
Color KML by age or depth
Constraints: {'enum': ['age', 'depth']}
latitude
(number, query, optional)
Latitude for radius search
Constraints: {'minimum': -90, 'maximum': 90}
limit
(integer, query, optional)
Limit results to specified number (max 20000)
Constraints: {'minimum': 1, 'maximum': 20000}
longitude
(number, query, optional)
Longitude for radius search
Constraints: {'minimum': -180, 'maximum': 180}
maxalertlevel
(string, query, optional)
Maximum PAGER alert level
Constraints: {'enum': ['green', 'yellow', 'orange', 'red']}
maxcdi
(number, query, optional)
Maximum Community Determined Intensity (DYFI)
Constraints: {'minimum': 0, 'maximum': 12}
maxdepth
(number, query, optional, default: 1000)
Maximum depth in km
Constraints: {'minimum': -100, 'maximum': 1000}
maxgap
(number, query, optional)
Maximum azimuthal gap
Constraints: {'minimum': 0, 'maximum': 360}
maxlatitude
(number, query, optional, default: 90)
Maximum latitude (-90 to 90)
Constraints: {'minimum': -90, 'maximum': 90}
maxlongitude
(number, query, optional, default: 180)
Maximum longitude (-360 to 360)
Constraints: {'minimum': -360, 'maximum': 360}
maxmagnitude
(number, query, optional)
Maximum magnitude
maxmmi
(number, query, optional)
Maximum Modified Mercalli Intensity (ShakeMap)
Constraints: {'minimum': 0, 'maximum': 12}
maxradius
(number, query, optional, default: 180)
Maximum degrees from point. Mutually exclusive with maxradiuskm
Constraints: {'minimum': 0, 'maximum': 180}
maxradiuskm
(number, query, optional, default: 20001.6)
Maximum km from point. Mutually exclusive with maxradius
Constraints: {'minimum': 0, 'maximum': 20001.6}
maxsig
(integer, query, optional)
Maximum significance
minalertlevel
(string, query, optional)
Minimum PAGER alert level
Constraints: {'enum': ['green', 'yellow', 'orange', 'red']}
mincdi
(number, query, optional)
Minimum Community Determined Intensity
mindepth
(number, query, optional, default: -100)
Minimum depth in km
Constraints: {'minimum': -100, 'maximum': 1000}
minfelt
(integer, query, optional)
Minimum DYFI responses
Constraints: {'minimum': 1}
mingap
(number, query, optional)
Minimum azimuthal gap
Constraints: {'minimum': 0, 'maximum': 360}
minlatitude
(number, query, optional, default: -90)
Minimum latitude (-90 to 90)
Constraints: {'minimum': -90, 'maximum': 90}
minlongitude
(number, query, optional, default: -180)
Minimum longitude (-360 to 360)
Constraints: {'minimum': -360, 'maximum': 360}
minmagnitude
(number, query, optional)
Minimum magnitude
minsig
(integer, query, optional)
Minimum significance
nodata
(integer, query, optional, default: 204)
HTTP code when no data found
Constraints: {'enum': [204, 404]}
offset
(integer, query, optional, default: 1)
Return results starting at specified event count
Constraints: {'minimum': 1}
orderby
(string, query, optional, default: time)
Order results by time or magnitude
Constraints: {'enum': ['time', 'time-asc', 'magnitude', 'magnitude-asc']}
productcode
(string, query, optional)
Return event associated with product code
producttype
(string, query, optional)
Limit to events with specific product type
Constraints: {'enum': ['moment-tensor', 'focal-mechanism', 'shakemap', 'losspager', 'dyfi']}
reviewstatus
(string, query, optional, default: all)
Filter by review status
Constraints: {'enum': ['automatic', 'reviewed', 'all']}
starttime
(string, query, optional)
Limit to events on or after specified time (ISO8601)
updatedafter
(string, query, optional)
Limit to events updated after specified time
Examples (2)
| Title | Type | URL | Action |
|---|---|---|---|
| Search earthquake events | openapi-spec |
https://earthquake.usgs.gov/fdsnws/event/1/query?starttime=2024-01-01&endtime=2024-01-31&minmagnitude=5.0&eventid=ci40453703&catalog=us&contributor=us&eventtype=earthquake |
|
| Search earthquake catalog | openapi-spec |
https://earthquake.usgs.gov/fdsnws/event/1/query?starttime=2024-01-01&endtime=2024-01-02 |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:19:13.457591 | 204 | 281ms | |
| 2026-03-23 10:17:27.610053 | 200 | 370ms |
Response Changes
| When | Old | New |
|---|---|---|
| 2026-03-23 10:19:13.457591 | 298beb1b1d84 |
e3b0c44298fc |