GET /irisws/timeseries/1/query

iris.edu:iris-web-services

Summary: Get time series data
Operation ID: getTimeSeries
Auth: none

Request seismic time series data in various formats with optional signal processing. This is an IRIS-specific service that provides more flexibility than the standard FDSN dataselect endpoint. Supports output formats: miniSEED (standard binary), SAC (Seismic Analysis Code format), ASCII (human-readable text), PNG (plot image), and WAV (audio). Optional processing includes: applying instrument correction (removing instrument response), filtering (bandpass, lowpass, highpass), and demeaning. Use this when you need processed data rather than raw miniSEED, or when you want to quickly visualize data as a PNG plot or listen to it as audio (WAV).

Original spec description

Retrieve and process time series data from IRIS archives. Supports various output formats and signal processing options.

Usage Tips

- Supported output formats: miniseed, sac, ascii, png, wav - Maximum time window is typically 30 days, but varies by output format - The correct=true parameter removes instrument response (converts counts to physical units) - Filter format: 'BP 0.01 0.1' for 0.01-0.1 Hz bandpass (check docs for exact syntax) - ASCII output is useful for quick checks but creates large files; use miniSEED for production - PNG output generates a simple waveform plot image - WAV output lets you 'listen' to seismic data (seismograms as audio) - Some output formats have stricter time limits than others

Parameters (35)

antialias (boolean, query, optional)

Apply anti-aliasing to plot (format=plot only)

audiocompress (boolean, query, optional)

Apply dynamic range compression (format=audio only)

audiosamplerate (integer, query, optional)

Audio sample rate in Hz (format=audio only)

autolimits (string, query, optional)

Auto frequency limits (lowerdBdown-upperdBdown)

bp (string, query, optional)

Band-pass filter frequencies in Hz (HI-LO)

cha (string, query, optional)

Channel code (required)

channel (string, query, optional)

Channel code (alias for cha)

correct (boolean, query, optional)

Apply instrument correction

decimate (number, query, optional)

Decimate to specified sample rate

demean (boolean, query, optional)

Remove mean value from data

diff (boolean, query, optional)

Differentiate time series

divscale (number, query, optional)

Scale data by inverse of factor

duration (integer, query, optional)

Duration in seconds (alternative to end time)

end (string, query, optional)

End time. ISO 8601 format.

endtime (string, query, optional)

End time (alias for end)

envelope (boolean, query, optional)

Calculate envelope of time series

format (string, query, optional)

Output format (required)

Constraints: {'enum': ['miniseed', 'sac.zip', 'saca', 'sacbb', 'sacbl', 'plot', 'ascii', 'ascii1', 'ascii2', 'geocsv', 'geocsv.tspair', 'geocsv.slist', 'audio']}

freqlimits (string, query, optional)

Frequency limits for deconvolution (F1-F2-F3-F4)

height (integer, query, optional)

Image height in pixels (format=plot only)

hp (number, query, optional)

High-pass filter frequency in Hz

int (boolean, query, optional)

Integrate time series

loc (string, query, optional)

Location code (required). Use -- for empty.

location (string, query, optional)

Location code (alias for loc)

lp (number, query, optional)

Low-pass filter frequency in Hz

net (string, query, optional)

Network code (required)

network (string, query, optional)

Network code (alias for net)

output (string, query, optional)

Output format (alias for format)

scale (string, query, optional)

Scale data by factor or AUTO

sta (string, query, optional)

Station code (required)

start (string, query, optional)

Start time (required). ISO 8601 format.

starttime (string, query, optional)

Start time (alias for start)

station (string, query, optional)

Station code (alias for sta)

taper (string, query, optional)

Apply taper. Format: fraction[,type] where type is HANNING, HAMMING, or COSINE

units (string, query, optional)

Output units (requires correct=true)

Constraints: {'enum': ['DEF', 'DIS', 'VEL', 'ACC']}

width (integer, query, optional)

Image width in pixels (format=plot only)

Examples (4)

TitleTypeURLAction
Basic miniSEED time series request curl https://service.iris.edu/irisws/timeseries/1/query?net=IU&sta=ANMO&loc=00&cha=BHZ&start=2024-01-01T00:00:00&end=2024-01-01T01:00:00&output=miniseed
ASCII output with bandpass filter curl https://service.iris.edu/irisws/timeseries/1/query?net=IU&sta=ANMO&loc=00&cha=BHZ&start=2024-01-01T00:00:00&end=2024-01-01T01:00:00&output=ascii&filter=BP%200.01%200.1
SAC format with instrument correction curl https://service.iris.edu/irisws/timeseries/1/query?net=IU&sta=ANMO&loc=00&cha=BHZ&start=2024-01-01T00:00:00&end=2024-01-01T01:00:00&output=sac&correct=true
Get time series data openapi-spec https://service.iris.edu/irisws/timeseries/1/query?net=IU&sta=ANMO&loc=00&cha=BHZ&start=2024-01-01T00:00:00&end=2024-01-01T01:00:00&duration=3600&format=miniseed&taper=0.05,HANNING&bp=0.1-10.0&audiosamplerate=16000

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:19:03.408106 200 1123ms
2026-03-23 10:09:06.365897 400 877ms
2026-03-23 09:48:52.553384 400 848ms
2026-03-23 09:04:21.880739 400 880ms

Response Changes

WhenOldNew
2026-03-23 09:48:52.553384 f6cb3c92768b f5cc6fbbfbf7
2026-03-23 10:09:06.365897 f5cc6fbbfbf7 6ab987c82891
2026-03-23 10:19:03.408106 6ab987c82891 69d688ecdbff