GET /fdsnws/availability/1/query

iris.edu:iris-web-services

Summary: Get data availability information
Operation ID: getAvailability
Auth: none

Query data availability from seismic stations. This endpoint tells you whether time series data actually exists for specific stations, channels, and time ranges—without downloading the full data. Returns availability information showing which time segments have data and which don't. This is essential before making large data requests: you can verify data exists before downloading potentially gigabytes of time series. The response can be formatted as text (default) or JSON. Unlike the station endpoint which returns metadata about stations, this endpoint returns information about what data is actually stored and available.

Original spec description

Returns information about time series data availability for specified channels.

Usage Tips

- Always check availability before requesting large amounts of data from dataselect - Use format=text for human-readable output; format=json for programmatic parsing - The nodata parameter controls HTTP status when no data is found (204 or 404) - Wildcards work for network, station, location, and channel codes - Time ranges must be specified in ISO 8601 format - Response shows start/end times of contiguous data segments - Some stations may have gaps in data (multiple segments per channel)

Parameters (8)

channel (string, query, optional)

Channel code

endtime (string, query, optional)

End time (ISO 8601)

format (string, query, optional)

Output format

Constraints: {'enum': ['text', 'json', 'post']}

location (string, query, optional)

Location code

network (string, query, optional)

Network code

nodata (integer, query, optional)

HTTP status code when no data found

Constraints: {'enum': [204, 404]}

starttime (string, query, optional)

Start time (ISO 8601)

station (string, query, optional)

Station code

Examples (4)

TitleTypeURLAction
Query specific station availability curl https://service.iris.edu/fdsnws/availability/1/query?network=IU&station=ANMO&channel=BHZ&starttime=2024-01-01T00:00:00&endtime=2024-01-02T00:00:00
Query with wildcards for multiple channels curl https://service.iris.edu/fdsnws/availability/1/query?network=US&station=COLA&location=00&channel=HH?&starttime=2024-03-01T00:00:00&endtime=2024-03-01T12:00:00&format=text
Query multiple networks with list syntax curl https://service.iris.edu/fdsnws/availability/1/query?network=IU,US&station=*&channel=BHZ,BHN&starttime=2024-06-01T00:00:00&endtime=2024-06-01T06:00:00&nodata=404
Get data availability information openapi-spec https://service.iris.edu/fdsnws/availability/1/query?network=IU&station=ANMO&format=text

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:29:00.516905 200 950ms
2026-03-23 10:12:12.227683 200 1092ms 2.0MB
2026-03-23 09:35:32.848234 200 3937ms
2026-03-23 09:15:21.222265 404 857ms

Response Changes

WhenOldNew
2026-03-23 09:35:32.848234 9c9ab4d323eb b3c04bded6b7
2026-03-23 10:12:12.227683 b3c04bded6b7 87a46a8c0b33
2026-03-23 10:29:00.516905 87a46a8c0b33 f4a675d44a79