ESM FDSNWS Station Web-Service

Sample requests

Publicly Available Data

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/fdsnws/station/1/query?network=IT&level=channel&format=text"
curl -X POST -F "message=@path/to/token.txt" "https://esm-db.eu/fdsnws/station/1/query?network=IT&level=channel"
curl -X POST -F "message=@path/to/token.txt" "https://esm-db.eu/fdsnws/station/1/query?starttime=2015-01-01T00:00:00&endtime=2015-12-31T23:59:59&level=station"
curl -X POST -F "message=@path/to/token.txt" "https://esm-db.eu/fdsnws/station/1/query?latitude=42.3&longitude=13.4&maxradius=1"

HTTP-POST variables (required)

Option	Description
message	The clearsign token obtained from the generate-signed-message authentication webservice.

Query options

URL format

Option	Description	Default
level	{network,station,channel} Specify the level of detail for the results.	station
starttime	Limit to metadata epochs starting on or after the specified start time. NOTE: since these times are often unknown for stations, they refer to seismic events recorded by them.	1900-01-01T00:00:00
endtime	Limit to metadata epochs ending on or before the specified end time. NOTE: since these times are often unknown for stations, they refer to seismic events recorded by them.	2100-01-01T00:00:00
network	Select one or more network codes. Can be SEED network codes or data center defined codes. Multiple codes are comma-separated. It must be a valid ASCII. Allowed wildcard: '*' (matches zero or more characters) or '?' (matches a single character).	*
station	Select one or more SEED station codes. Multiple codes are comma-separated. It must be a valid ASCII. Allowed wildcard: '*' (matches zero or more characters) or '?' (matches a single character).	*
location	Select one or more SEED location identifiers. Multiple identifiers are commaseparated. As a special case '--' (two dashes) will be translated to a string of two space characters to match blank location IDs. It must be a valid ASCII. Allowed wildcard: '*' (matches zero or more characters) or '?' (matches a single character).	*
channel	Select one or more SEED channel codes. Multiple codes are comma-separated. It must be a valid ASCII. Allowed wildcard: '*' (matches zero or more characters) or '?' (matches a single character).	*
minlatitude	Square selection: limit to stations with a latitude larger than or equal to the specified minimum.	-90
maxlatitude	Square selection: limit to stations with a latitude smaller than or equal to the specified maximum.	90
minlongitude	Square selection: limit to stations with a longitude larger than or equal to the specified minimum.	-180
maxlongitude	Square selection: limit to stations with a longitude smaller than or equal to the specified maximum.	180
latitude	Circular selection: specify the latitude to be used for a radius search.	0
longitude	Circular selection: specify the longitude to the used for a radius search.	0
minradius	Circular selection: limit to stations within the specified minimum number of degrees from the geographic point defined by the latitude and longitude parameters.	0
maxradius	Circular selection: limit to stations within the specified maximum number of degrees from the geographic point defined by the latitude and longitude parameters.	180
format	{xml,text} Specify format of result, either 'xml' or 'text'.	xml

Backend Python software used by this web service was originally developed by Puglia R. and Russo E., and it is currently maintained by Russo E. and Felicetta C.