ESM Dataset Selection Web-Service

Sample requests

Data can be obtained using any program supporting the HTTP-GET method, e.g. your favourite web browser:

Restricted Data (authenticated users only)

ESM Administrators and users with special authorizations can access data intended for internal use and/or embargoed.
Data can be obtained using any program supporting the HTTP-POST method, e.g. CURL:

curl -X POST -F "message=@path/to/token.txt" "https://esm-db.eu/esmws/dataset-selection/1/query?starttime=2012-01-10&endtime=2012-01-20&unprocessed=false&qc=false&qd=false"
curl -X POST -F "message=@path/to/token.txt" "https://esm-db.eu/esmws/dataset-selection/1/query?network=IV&minmag=5&maxdist=30"

Query options

HTTP-POST variables (required)

Option	Description	Default
message	The clearsign token obtained from the generate-signed-message authentication webservice or from EIDA authentication webpage.

URL format

Option	Description	Default
eventid	ESM event ID. Supported wildcard are or '*' (matches zero or more characters) or '?' (matches just one character).	'*'
starttime	Limit to events on or after the specified start time. Allowed formats: 'YYYY-MM-DDTHH:MM:SS' and 'YYYY-MM-DD'.	'1900-01-01T00:00:00'
endtime	Limit to events on or before the specified end time. Allowed formats: 'YYYY-MM-DDTHH:MM:SS' and 'YYYY-MM-DD'.	'2100-01-01T00:00:00'
minmag	Limit to events with a magnitude larger than the specified minimum.	0
maxdist	Limit to stations with epicentral distance smaller than the specified maximum.	3000
network	Network code. Supported wildcard are or '*' or '?'.	'*'
station	Station code. Supported wildcard are or '*' or '?'.	'*'
instrument	Instrument code. Supported wildcard are or '*' or '?'.	'*'
unprocessed	{true,false} Include unprocessed data.	true
discarded	{true,false} Include manually discarded data.	true
automatic	{true,false} Include automatically processed data.	true
manual	{true,false} Include manually processed data.	true
standard	{true,false} Include data processed with default processing method (Paolucci et al. 2011 aka ITACA) as preferred (manual or automatic modes).	true
ebasco	{true,false} Include data processed with eBASCO method (Schiappapietra et al. 2021) as preferred (only manual mode).	true
processing-filter-logic	{preferred,available} Specify a criterion for filter on processing scheme: 'available': the processing scheme specified by 'automatic/manual' and 'standard/ebasco' options is available for selected waveforms. 'preferred' (the processing scheme specified by 'automatic/manual' and 'standard/ebasco' options is the preferred scheme for selected waveforms.	preferred
best	{true,false} Include data classified as 'best quality'.	true
good	{true,false} Include data classified as 'good quality'.	true
bad	{true,false} Include data classified as 'bad quality'.	true
undef	{true,false} nclude data classified as 'undefined'.	true
quality-reason	Select 'all' or one or more quality reason codes (see table below for description). Multiple codes are comma-separated.	all
format	{json} Specify format of result, currently only 'json' is supported.	'json'
offset	Pagination offset. NOTE: setting offset=0 and limit=0 disables pagination.	0
limit	Pagination limit. NOTE: setting offset=0 and limit=0 disables pagination.	0
indent	{true,false} Prettifies output setting a 4 spaces indentation style. Valid only in combination with 'json' format.	false

Quality reason codes for 'quality-reason' option can be retrived here

Backend Python software used by this web service is developed and maintained by Russo E. and Felicetta C.