FDSN Station Web Service

Description URL Builder

This form creates a URL that searches SCEDC metadata based on the criteria entered in the fields below. The URL will change as you type in the fields. The station web service returns station metadata in FDSN StationXML format (schema here) or as delimited text. Results are available at four different levels of granularity: network, station, channel and response. Metadata may be selected based on channel descriptiors, time ranges, geographic regions and more.

NOTE: The SCEDC will start serving station XML v1.1 starting April 28, 2020

When accessing SCEDC data, please consider first using our AWS Open Dataset (https://scedc.caltech.edu/data/cloud.html). This is the fastest way to access data and is free of charge. If you do choose to use FDSN webservices please be limit your downloads to 3 concurrent sessions. Excessive downloads will result in your IP(s) being blacklisted.

To see a full list of service parameters and their usage, click

Specify the level of detail to return. level= network|station|channel|response (station level is default).

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=CI&sta=M*
/fdsnws/station/1/query?net=C*&sta=*A*&format=text
/fdsnws/station/1/query?net=CI&sta=P*D*
/fdsnws/station/1/query?net=CI&sta=BAK&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=CI,NP
/fdsnws/station/1/query?net=CI,NP&sta=C*,V*&format=text
[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=30.0 :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.

Examples:

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=CI.
sta="station"	Optional	Specify SEED station code, example sta=BAK.
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	Optional	Specify channels starting before this date.
startafter=YYYY-MM-DDThh:mm:ss	Optional	Specify channels starting after this date.
endbefore=YYYY-MM-DDThh:mm:ss	Optional	Specify channels ending before this date.
endafter=YYYY-MM-DDThh:mm:ss	Optional	Specify channels ending after this date.
start=YYYY-MM-DDThh:mm:ss	Optional	Specify channels operating after this date.
end=YYYY-MM-DDThh:mm:ss	Optional	Specify channels operating before this date.
updatedafter=YYYY-MM-DDThh:mm:ss	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).

URL Builder

Station

net

sta

cha

loc

Location (all inputs are in decimal degrees)

Min Lat

Max Lat

Min Lon

Max Lon

Ring Radius (all inputs are in decimal degrees)

Lat

Lon

Min Radius

Max Radius

Time (Date format: YYYY-MM-DDThh:mm:ss)

Note: Time filters are applied against channel epochs.

start before

start after

end before

end after

start

end

updated after

Output

Format

Details Level

level

Data Availability

Include Availability

URL:/fdsnws/station/1/query?nodata=404

Submission Form

WADL

Retrieve the WADL associated with this service: application.wadl

Please use the citation:
SCEDC (2013): Southern California Earthquake Data Center. Caltech. Dataset. doi:10.7909/C3WD3xH1 to cite data downloaded from the SCEDC.

Version: FDSN Station Service:1.1.0