FDSN Availability Web Service
Home »
NCEDC Web Services » FDSN Availability
Description Usage URL Builder Help
The availability web service returns detailed time span information of what timeseries data are available at the NCEDC in JSON or text format.
There are two service query methods:
/extent
Produces lists of available time extents (earliest to latest) for selected channels (network, station, location and quality) and time ranges.
/query
Produces lists of contiguous time spans for selected channels (network, station, location, channel and quality) and time ranges.
Examples:
There are two service query methods:
/extent
Produces lists of available time extents (earliest to latest) for selected channels (network, station, location and quality) and time ranges.
/query
Produces lists of contiguous time spans for selected channels (network, station, location, channel and quality) and time ranges.
Examples:
- /fdsnws/availability/1/query?net=BK&sta=MERC&cha=HHE&start=2024-01-01T00:00:00&end=2024-02-01T00:00:00&format=text
- /fdsnws/availability/1/extent?net=BK&sta=MERC,MOD&cha=HHE&start=2024-01-01T00:00:00&end=2024-02-01T00:00:00&format=json
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. 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/availability/1/query|extent?[query-parameters] | ||
where query-parameters: | ||
net="network" | Optional | Specify SEED network code, example net=BK. Wildcards and lists accepted. |
sta="station" | Optional | Specify SEED station code, example sta=CMB. Wildcards and lists accepted. |
cha="channel" | Optional | Specify SEED channel code mask, example: cha=BHE. Wildcards and lists accepted. |
loc="location" | Optional | Specify SEED location code mask, example: loc=00. Wildcards and lists accepted. Substitute dash characters for white space, example: loc=--. |
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. |
qual="quality" | Optional | Select based on SEED quality codes D, M, Q, R. Comma separated lists are accepted. |
merge="samplerate,quality,overlap" | Optional | Time spans from data with different sample rates/quality or that overlap will be merged together. |
mergegaps="seconds" | Optional | Merge time spans that are separated by the specified tolerance in seconds (only applicable to query end point). |
format=json/text | Optional | Specify output format (Default is json). |
nodata=204/404 | Optional | Specify which HTML status code is returned when no data is found (Default is 204). |
Query Submission Form | |
Extent Submission Form | |
Version: FDSN Availability Service:1.0