FDSN Station Web Service
Home »
NCEDC Web Services » FDSN Station
Description Usage URL Builder Help
The station web service station metadata in FDSN StationXML format (schema here) or in text format.
Results are available at four different levels of detail.
Other options
Results are available at four different levels of detail.
- level= network|station|channel|response :Specify the level of detail to return (station level is default).
- /fdsnws/station/1/query?net=B*&level=network
- /fdsnws/station/1/query?net=BK&sta=MOD&level=station
- /fdsnws/station/1/query?net=BK&sta=MOD&level=channel
- /fdsnws/station/1/query?net=BK&sta=MOD&cha=BHE&level=response
Other options
The following options are available:
- Wild cards: Only supported for net[work],sta[tion],cha[nnel],loc[ation]. Examples: /fdsnws/station/1/query?net=BK&sta=M* /fdsnws/station/1/query?net=B*&sta=*A* /fdsnws/station/1/query?net=BK&sta=P*D* /fdsnws/station/1/query?net=BK&sta=MOD&cha=BH*&level=channel
- Comma seperated list is now supported in search criteria, valid for net[work],sta[tion],cha[nnel],loc[ation]. Examples: /fdsnws/station/1/query?net=BK,BP /fdsnws/station/1/query?net=BK,BP&sta=C*,V*
- [lat,lon,maxradius [minradius]]="degrees", stations can be filtered now based on radius location. Example: /fdsnws/station/1/query?lat=40.0&lon=-122.0&minradius=0.0&maxradius=0.5 :minradius is optional, it defaults to 0.0
- updatedAfter: This parameter is used if you are only interested in data that has been updated after a specific date, this eliminate the needs to download the full set of data and instead allow the user to retrieve a smaller set of modified data if any.
POST Usage: Alternately, instead of providing parameters-value pairs in the URL, a file containing a selection list can be POSTed to this service. For the POST method, all parameters must be submitted as part of the POST body. POST requests should be sent as plain text and should not be formatted as applcation/x-www-form-urlencoded or multipart/form-data. Time and channel constraints parameters should be repeated as many times as necessary following this pattern:
NET | STA | LOC | CHA | STARTTIME | ENDTIME |
NET | STA | LOC | CHA | STARTTIME | ENDTIME |
NET | STA | LOC | CHA | STARTTIME | ENDTIME |
All rules for parameters apply equally whether specified using the GET or POST methods with the exception of blank location IDs, which must be specified as "--" in the POST body due to spaces being used as the field separator. The parameters startbefore, startafter, endbefore, and endafter are NOT supported in POST. All other valid parameter-value pairs for GET queries are also valid for POST queries. Parameter-value pairs should be listed at the top of the file and are entirely optional. Below is a full list of service parameters and their usage.
Query:/fdsnws/station/1/query?[query-parameters] | ||
where query-parameters: | ||
Empty/No parameters | Optional | Will return all stations - level defaults to station. |
net="network" | Optional | Specify SEED network code, example net=BK. |
sta="station" | Optional | Specify SEED station code, example sta=CMB. |
cha="channel" | Optional | Specify SEED channel code mask, example: cha=BHE. |
loc="location" | Optional | Specify SEED location code mask, example: loc=00. substitute dash characters for white space, example: loc=--. |
minlat="degrees" | Optional | Specify minimum latitude, northern boundary [-90 <= X <= 90]. |
maxlat="degrees" | Optional | Specify maximum latitude, southern boundary [-90 <= X <= 90]. |
minlon="degrees" | Optional | Specify minimum longitude, western boundary [-180 <= X <= 180]. |
maxlon="degrees" | Optional | Specify maximum longitude, eastern boundary [-180 <= X <= 180]. |
[lat,lon,maxradius [minradius]]="degrees" | Optional | Geographic circular bounding area. All lat, lon, maxradius parameters must be given together. minradius parameter is optional and defaults to zero. Cannot be combined with minlat, maxlat, minlon, maxlon. |
startbefore=YYYY-MM-DDThh:mm:ss[.sss] | Optional | Specify channels starting before this date. |
startafter=YYYY-MM-DDThh:mm:ss[.sss] | Optional | Specify channels starting after this date. |
endbefore=YYYY-MM-DDThh:mm:ss[.sss] | Optional | Specify channels ending before this date. |
endafter=YYYY-MM-DDThh:mm:ss[.sss] | Optional | Specify channels ending after this date. |
start=YYYY-MM-DDThh:mm:ss[.sss] | Optional | Specify channels operating after this date. |
end=YYYY-MM-DDThh:mm:ss[.sss] | Optional | Specify channels operating before this date. |
updatedafter=YYYY-MM-DDThh:mm:ss[.sss] | Optional | Query stations updated after a specific date. |
level=network/station/channel/response | Optional | Specify whether to include channel/response metadata or not. |
includeavailability=true/false | Optional | Specify if results should include information about time series data availability. |
format=xml/text | Optional | Specify output format (Default is xml). |
nodata=204/404 | Optional | Specify which HTML status code is returned when no data is found (Default is 204). |
Submission Form | |
Version: FDSN Station Service:1.1.1