FDSN Event Web Service
The FDSN event web service returns event(earthquake) in QuakeML format (schema here). Events may be selected based on location, time, catalog, contributor and internal identifiers. By default, events are retrieved from the SCEDC catalog. These default results include the catalog's "primary origin" and "primary magnitude" for each event, they may optionally include all available origin and magnitude estimates. By default, results are returned in QuakeML format, but may also be requested in text format. Please limit your search to smaller time periods.
Note: Due to current limitations, we are no longer able to support the 'includeallorigins' option.
To see a full list of service parameters and their usage, clickExamples:
- /fdsnws/event/1/query?eventid=37372448&format=xml
- /fdsnws/event/1/query?starttime=2015-01-01T00:00:00&endtime=2015-01-02T00:00:00&format=text
- /fdsnws/event/1/query?eventid=37372448,37372456&includeallmagnitudes=true&format=text
- /fdsnws/event/1/query?starttime=2015-01-01T00:00:00&endtime=2015-01-02T00:00:00&minmag=1&maxmag=5&mindepth=0&maxdepth=500.0&format=xml
Below is a full list of service parameters and their usage.
Query:/fdsnws/event/1/query?[query-parameters] | ||
where query-parameters: | ||
starttime="YYYY-MM-DDThh:hh:ss" | Optional | Specify the start date and time. |
endtime="YYYY-MM-DDThh:hh:ss" | Optional | Specify the end date and time. |
minmag="magnitude" | Optional | Specify the lower limit of magnitude. |
maxmag="magnitude" | Optional | Specify the upper limit of magnitude. |
mindepth="depth " | Optional | Specify the lower limit of depth in km. |
maxdepth="depth" | Optional | Specify the upper limit of depth in km. |
BOX search parameters, incompatible with Radial search parameters | ||
minlat="degrees" | Optional | Specify minimum latitude, northern boundary [-39 <= X <= 39]. |
maxlat="degrees" | Optional | Specify maximum latitude, southern boundary [-30 <= X <= 30]. |
minlon="degrees" | Optional | Specify minimum longitude, western boundary [-124 <= X <= 124]. |
maxlon="degrees" | Optional | Specify maximum longitude, eastern boundary [-111 <= X <= 111]. |
contributor="SCSN" | Optional | This is readonly and set to SCSN for this web service. |
catalog=[SCEDC, DS2000, HAUK2003, HAUK2004, SHLK2005, YHS2011] | Optional | Specify the catalog to be queried for events. Default is SCEDC. Filters under "Others" ar\ e not applicable when catalog is not SCEDC and will be greyed out. |
Radial search parameters, incompatible with BOX search parameters | ||
[lat,lon,maxradius [minradius]]="degrees" | Optional | Geographic circular bounding area. All lat, lon, maxradius parameters must be given together. minradius parameter is optional and defaults to zero. Cannot be combined with minlat, maxlat, minlon, maxlon. |
Event search parameters | ||
eventid="evid1,evid2,...." | Optional | Specify one or more eventids (comma separated). |
Other filters | ||
magtype="magtype" | Optional | Specify the magnitude type. |
includeallmagnitudes=true/false | Optional | Specify if results should include all magnitudes associated with an event. Default is display only preferred magnitude. |
includearrivals=true/false | Optional | Specify if results should include all arrivals associated with an event. |
includemechanisms=true/false | Optional | Specify if results should include focal mechanisms, moment tensors associated with an event. |
limit="limit" | Optional | Limit results to the specified number. |
offset="offset" | Optional | Return results starting at the event count specified. |
orderby="orderby" | Optional | Specify how the results should be ordered. Options are time, time ascending or magnitude, magnitude ascending. Default is time, descending. |
format=xml/text | Optional | Specify output format (Default is xml or quakeml). |
nodata=204|404 | Optional | Specify which HTML status code is returned when no data is found (Default is 204). |