IRIS DMC IRISWS availability Web Service Documentation

Description

The irisws-availability web service returns detailed time span information of what timeseries data is available at the DMC archive

Below is a full list of service parameters and their usage.

Query Usage

/query? [channel-options] [time-constraints] [merge-options] [format-options] [nodata=404] 

where

channel-options    ::  [net=<network>] [sta=<station>] [loc=<location>] [cha=<channel>] [quality=<quality>]
time-constraints   ::  [starttime=<date>] [endtime=<date>]
merge-options      ::  [mergeoverlap=<true|false>] [mergesamplerate=<true|false>] [mergetolerance=<true|false>]
passive-options    ::  [nodata=404]

Query parameters are joined by ampersands ”&”, without blank space (see the sample queries).

POST Usage

Alternatively, instead of providing parameter-value pairs in the URL, a file containing a selection list can be POSTed to this service. This is the same method used with the fdsnws-station and fdsnws-dataselect webservices. For additional details, including an example selection file, visit the Help section.

nodata=404
Network Station Location Channel StartTime EndTime
Network Station Location Channel StartTime EndTime
...

Wildcards are acceptable for Network, Station, Location, and Channel. Click here for time format details.

Sample Queries

*Basic: Data from network IM, station NV31
http://service.iris.edu/irisws/availability/1/query?network=IM&station=NV31&starttime=2010-02-03T09:00:00&endtime=2010-02-04T10:00:00

Detailed Descriptions of each Query Parameter

parameter examples discussion default type
format json Specify output format. Accepted values are text (the default), geocsv, json and sync geocsv string
Channel contraints
net[work] IU Select one or more network codes. Can be SEED codes or data center defined codes. Accepts wildcards and lists. any string
sta[tion] ANMO Select one or more SEED station codes. Accepts wildcards and lists. any string
loc[ation] 00 Select one or more SEED location identifier. Use -- for “Blank” location IDs (ID’s containing 2 spaces). Accepts wildcards and lists. any string
cha[nnel] BH1 Select one or more SEED channel codes. Accepts wildcards and lists. any string
Time constraints
start[time] 2015-10-18T00:00:00 Limit to metadata listed on or after the specified start time. any day/time
end[time] 2016-06-27T00:00:00 Limit to metadata listed on or before the specified end time. any day/time
Merge options
mergeoverlap true Description here. false true/false
mergesamplerate true Description here. false true/false
mergetolerange 86400.0 SecondsDescription here. 0.0 Float
Other Options these are passive options, passed through in the response but otherwise unused
includequality true Description here. true— true/false
nodata 404 Specify which HTTP status code is returned when no data is found.1 204 204 or 404

1 By default, the service returns a HTTP response code 204, which means the request was successful, but no data (no content) was retrieved. However, because there was no “error”, no error message is generated and it may appear that the browser did nothing. To force an empty query response to display an error message, add nodata=404 to the URL.


Date and Time Formats

Year, Month, Day in Month — Time:

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 of month (01 through 31)
T	:: date-time separator
hh	:: two digits of hour (00 through 23) (AM/PM NOT allowed)
mm	:: two digits of minute (00 through 59)
ss	:: two digits of second (00 through 59)
ssssss	:: one to six digits representing decimal fractions of a second, down to microseconds

VERSION

HOST

BASEURL

IRISWS availability web service