FDSN WS-EVENT API demonstration

This HTTP web service implements the FDSN WS-EVENT specification and provides access to the EMSC event catalogue. Event information can include all origins and all arrivals if requested. Output formats can be Quakeml, json or text (csv). A full description of the data products and the specifications of the web service are in this document.

This webpage will help you to learn to construct request urls for use in shell scripts (for example with curl or wget) or any programming language that provides http client connections.

The data provided by this service is distributed under the Creative Commons Attribution 4.0 International (CC BY 4.0) license. For further information, see our terms and conditions. This service is also integrated into the EPOS platform.

Automatically generated documentation can be found at docs or redoc. Tutorials are also available on the EMSC github account for use cases (python/shell/notebook) or in the form of Hands-on-Sessions (using python).

The API is described using openapi.json based on the OpenAPI specification. Other (older) frameworks can automatically generate bindings from a WADL description file that is available as application.wadl.

GroupParameterAbbrevationValueDefaultMinimumMaximumTypeUnits
time constraints
starttimestart[Any][Any valid time][Any valid time]TimeUTC
endtimeend[Any][Any valid time][Any valid time]TimeUTC
geographics constraints
box area constraints
minlatitudeminlat-90.0-90.090.0floatdegrees
maxlatitudemaxlat90.0-90.090.0floatdegrees
minlongitudeminlon-180.0-360.0360.0floatdegrees
maxlongitudemaxlon180.0-360.0360.0floatdegrees
circle constraints
latitudelat0.0-90.090.0floatdegrees
longitudelon0.0-180.0180.0floatdegrees
minradius0.00.0180.0floatdegrees
maxradius180.00.0180.0floatdegrees
output control
formatxmlxml, text, jsonstring
nodataxml204 or 404string
other parameters
mindepth[Any][Any][ANY]floatkilometers
maxdepth[Any][Any][ANY]floatkilometers
minmagnitudeminmag[Any][Any][ANY]float
maxmagnitudemaxmag[Any][Any][ANY]float
magnitudetypemagtype[Any]string
includealloriginsFALSEboolean
includearrivalsFALSEboolean
eventid
  (seismicportal id)
[Any]string
evid
  (EMSC website id)
[Any]string
limit200001integer
offset11integer
orderbytimetime, time-asc, magnitude, magnitude-ascinteger
contributor[Any]string
catalog[Any]EMSC-RTS, EMSC-EMBstring
updatedaftertimeUTC
Generated URL : {{serverName}}{{baseFDSNUrl}}?{{params}}
Call the Web Service Loading data

Raw Result :

{{erreur}}

Notes:

The FDSN server was updated (2023-03) to a more modern framework and the maximim number of events per request has increased to 20000. There may be small disparities with the previous server that require adjustments to your requests, for instance around the formats of times, please contact us if there are problems with the new server.

Update 2023-07: minlongitude/minlon and maxlongitude/maxlon now range between -360° and 360° intelligently wrapping at ±180°. It is considered that the minlon parameter defines the western limit while the maxlon parameter defines the eastern limit.

Update 2026-06: various improvements to the service's metadata were implemented.