FDSN Availability Web Service

Description

The fdsnws-availability web service returns detailed time span information of what timeseries data are available at the NCEDC
in JSON or text format.

Data may be selected based on channel descriptors, time ranges, and more.

This service is an implementation of the FDSN web service specification version 1.0.

Output format

JSON

Text
The text format contains parameters separated by a blank character

Sample text output for endpoint=query

# Network Station Location Channel Quality SampleRate Earliest Latest
BK MERC 00 HHE D 100.0 2024-01-01T07:17:13.8505Z 2024-01-01T07:19:54.3405Z
BK MERC 00 HHE D 100.0 2024-01-01T07:21:14.8905Z 2024-01-01T07:26:44.5205Z
BK MERC 00 HHE D 100.0 2024-01-01T07:29:48.5505Z 2024-01-01T07:33:17.6305Z

Sample text output for endpoint=extent

# Network Station Location Channel Quality SampleRate Earliest Latest Updated TimeSpans Restriction
BK MERC 00 HHE D 100.0 2024-01-01T07:17:13.8505Z 2024-01-31T11:21:06.1905Z 2024-02-09T15:36:15Z 84 OPEN
BK MERC 00 HHE Q 100.0 2024-01-01T00:00:00.0004Z 2024-01-31T23:59:59.9904Z 2024-02-02T06:10:05Z 1 OPEN

Data selection

The fdsnws-availability service allows data selection using the following parameters:

* Network, station, location and channel
* Time windowing
* Data quality

Using Wildcards and lists

Both wildcards and lists can be used for channel naming criteria: network, station, location, channel.

Wildcards

The service supports the use of * (asterisk) and ? (question mark) in specifying search criteria. The * is used to indicate any
combination of characters while ? is used to indicate one character only. They can be used at the beginning, middle or the end of
the search criteria.
Some examples: net=B*, net=*K, chan=B*Z or chan=B?Z.

Lists

Users can specify multiple networks, stations, channels or locations in their search criteria by providing comma separated list.
For example: sta=CMB,BKS or chan=BHZ,BHE.

wget example

Requests can be made with a selection file and the wget unix command line utility.

$ cat request
format=json
quality=Q
BK S* 00 LHZ 2015-01-11T01:11:00 2015-01-12T02:22:00
NC PM? * EHZ 2010-02-27T06:34:00 2010-02-27T08:00:00

$ wget --post-file=request -O output.json https://service.ncedc.org/fdsnws/availability/1/extent

This will send the request to the server and save the results in a file name output.json

curl example

Requests can also be made with a selection file and the curl unix command line utility.

$ cat request
format=text
merge=overlap
quality=Q,D
BK S* 00 LHZ 2015-01-11T01:11:00 2015-01-12T02:22:00
NC PM? * EHZ 2010-02-27T06:34:00 2010-02-27T08:00:00

$ curl --data-binary @request -o output.txt https://service.ncedc.org/fdsnws/availability/1/query

This will send the request to the server and save the results in a file name output.txt