FDSNWS station v1

Description

The fdsnws-station web service returns station metadata.

Query usage

/query? [channel-options] [time-options] [geographic-options] [output-options] [miscellaneous-options] [nodata=404]

Where:

channel-options       ::  [net=<network>] [sta=<station>] [loc=<location>] [cha=<channel>]
time-options          ::  [starttime=<date>] [endtime=<date>] [startbefore=<date>] [startafter=<date>] [endbefore=<date>] [endafter=<date>]
geographic-options    ::  [minlat=<degrees>] [maxlat=<degrees>] [minlon=<degrees>] [maxlon=<degrees>]
geographic-options    ::  [lat=<degrees>] [lon=<degrees>] [minradius=<degrees>] [maxradius=<degrees>]
output-options        ::  [level=<network|STATION|location|channel>] [format=<XML|text|mseed>]
miscellaneous-options ::  [includerestricted=<TRUE|false>] [matchtimeseries=<true|FALSE>] [updatedafter=<date>]

default values are uppercase

Sample queries

All RESIF networks : http://ws.resif.fr/fdsnws/station/1/query?level=network
Whole French accelerometric network (RAP): http://ws.resif.fr/fdsnws/station/1/query?network=FR,RA&channel=HN?&format=xml&level=station
Whole FR network, limit to channels which contains data: http://ws.resif.fr/fdsnws/station/1/query?network=FR&format=xml&level=channel&matchtimeseries=true

Detailed descriptions of each query parameter

Channel options

Parameter	Example	Discussion	Default	Type
net[work]	FR	Seismic network name. Accepts wildcards and lists.	any	string
sta[tion]	CIEL	Station name. Accepts wildcards and lists.	any	string
loc[ation]	00	Location code. Use loc=– for empty location codes. Accepts wildcards and lists.	any	string
cha[nnel]	HHZ	Channel Code. Accepts wildcards and lists.	any	string

Wildcards and lists

Wildcards: the question mark ? represents any single character, while the asterisk * represents zero or more characters.
List: multiple items may be retrieved using a comma-separated list. Wildcards may be included in the list.

For example, with channel codes: channel=EH?,BHZ

Time options

Parameter	Example	Discussion	Default	Type
start[time]	2010-01-10T00:00:00	Limits to metadata describing channels operating on or after the specified start time.	any	day/time
end[time]	2011-02-11T01:00:00	Limits to metadata describing channels operating on or before the specified end time.	any	day/time
startbefore	2002-12-31T00:00:00	Limits to metadata epochs starting before specified time. Applied to channel epochs.	any	day/time
startafter	2010-12-31T00:00:00	Limits to metadata epochs starting after specified time. Applied to channel epochs.	any	day/time
endbefore	2015-12-31T00:00:00	Limits to metadata epochs ending before specified time. Applied to channel epochs.	any	day/time
endafter	2012-12-31T00:00:00	Limits to metadata epochs ending after specified time. Applied to channel epochs.	any	day/time

Rectangular geographic constraints

Parameter	Example	Discussion	Default	Type
minlat[itude]	14.5	Southern boundary.	-90°	degrees
maxlat[itude]	22.0	Northern boundary.	90°	degrees
minlon[gitude]	-170.0	Western boundary.	-180°	degrees
maxlon[gitude]	170.0	Eastern boundary.	180°	degrees

Radial geographic constraints

Parameter	Example	Discussion	Default	Type
lat[itude]	45.0	Specify the central latitude point.	0	degrees
lon[gitude]	160.0	Specify the central longitude point.	0	degrees
maxradius	22.0	Specify maximum distance from the geographic point defined by latitude and longitude.		degrees
minradius	15.0	Specify minimum distance from the geographic point defined by latitude and longitude.	0	degrees

latitude, longitude, maxradius and minradius work together to define a radial boundary

Output options

Parameter	Example	Discussion	Default	Type
level	channel	Specify the level of detail using network, station, channel, or response.	station	level
format	text	Specify output format. Valid formats include xml, text, and mseed.	xml	format
nodata	404	Specify which HTTP status code is returned when no data is found.	204	204 or 404

Miscellaneous

Parameter	Example	Discussion	Default	Type
includerestricted	TRUE	Specify whether results should include information relating to restricted channels.	true	Boolean
matchtimeseries	TRUE	Retrieve only metadata that is likely to match available time series data.	false	Boolean
updatedafter	2013-01-01	Limits to metadata updated after specified UTC date; updates are data center specific.	any	day/time

Date and time formats

YYYY-MM-DDThh:mm:ss[.ssssss] ex. 1997-01-31T12:04:32.123
YYYY-MM-DD ex. 1997-01-31 (a time of 00:00:00 is assumed)

Where:

YYYY    :: four-digit year
MM      :: two-digit month (01=January, etc.)
DD      :: two-digit day (01 through 31)
T       :: date-time separator
hh      :: two-digit hour (00 through 23)
mm      :: two-digit number of minutes (00 through 59)
ss      :: two-digit number of seconds (00 through 59)
ssssss  :: one to six-digit number of microseconds (0 through 999999)

Additional information

Additional informations on webservive overview

You can also get help by sending an email at our helpdesk