QuakeLink

2022.124#1dde0d933

Web Service - Events

A web service to retrieve event information in either SeisComP XML (similar to QuakeML) or as plain summary (row based).

API Description

ParameterTypeDescription
Events
includelistSpecify whether to include pick/arrival/magnitude information or not. Valid values are: all, picks, arrs, amps, stamags, nonpref. Default is an empty list which retrieves only the preferred magnitude and origin without arrivals.
Event attributes
idstringSpecify the event id, example id=gfz2011ocqa.
If id is not given the result is plain text table where each row represents an event. The row format depends on the value of the format parameter.
revintegerSpecify a particular event revision, only used in combination with the id paramter.
Omit this parameter or use a value of -1 to query the latest revision.
minmagfloatSpecify the minimum magnitude.
maxmagfloatSpecify the maximum magnitude.
mag_tstringType of event magnitude.
mindepthfloatSpecify the minimum depth.
maxdepthfloatSpecify the maximum depth.
Rectangular bounding area
minlatdegreesSpecify minimum latitude, southern boundary [-90 <= X <= 90].
maxlatdegreesSpecify maximum latitude, northern boundary [-90 <= X <= 90].
minlondegreesSpecify minimum longitude, western boundary [-180 <= X <= 180].
maxlondegreesSpecify maximum longitude, eastern boundary [-180 <= X <= 180].
minphasescountSpecify minimum phases used in origin solution.
maxphasescountSpecify maximum phases used in origin solution.
Time queries
startdateSelect events with origin time after this date, format = %Y-%m-%d[T%H:%M:%S].
enddateSelect events with origin time before this date, format = %Y-%m-%d[T%H:%M:%S].
updatedbeforedateSelect events updated before this date, format = %Y-%m-%d[T%H:%M:%S].
updatedafterdateSelect events updated after this date, format = %Y-%m-%d[T%H:%M:%S].
Miscellaneous attributes
agencystringAgency creating the origin.
authorstringAuthor creating the origin.
statusstringCummulated evaluation status and evaluation mode of the origin
estatusstringEvaluation status of the origin.
emodestringEvaluation mode of the origin.
typestringEvent type, e.g. 'earthquake', 'not existing'.
regionstringEvent region.
Options
sortstringResult set order. Use time for ascending and -time for descending origin time order. Use mag for ascending and -mag for descending magnitude order.
limitintegerLimits the result set. A value > 0 is required.
offsetintegerOffset within the resultset. '0' denotes the first item.
gzipForce gzip compression. If omitted the server automatically checks if the client reports (x-)gzip support through Accept-Encoding (not yet for txt format).
downloadAdds the filename {eventid}.xml[.gz] to the HTTP response header. The browsers accepted encoding is then ignored and the result is only compressed if the gzip flag is passed as well.
formatintegerFormat of the text based event list (default: 1).
1: ${TIMESTAMP};${OTIME};${MAG};${MAG_T};${LAT};${LON};${DEPTH};${PHASES};${AGENCY};${STATUS};${TYPE};${REGION}
2: ${TIMESTAMP};${OTIME};${MAG};${MAG_T};${LAT};${LON};${DEPTH};${PHASES};${AGENCY};${AUTHOR};${STATUS};${EMODE};${ESTATUS};${TYPE};${REGION}