Skip to main content
GET
Query RSAM

Overview

The RSAM endpoints provide access to seismic amplitude data from AVERT monitoring stations. Query time-series data by network, station, and channel with flexible date range filtering.
Use /api/seismic/sites to discover available network/station/channel combinations before querying RSAM data.

Available Stations and Channels

Endpoints


GET /api/seismic/rsam

Returns a RSAM time-series for the requested channel between datefrom and dateto. Both dates are inclusive and results are returned in chronological order.

Parameters

string
required
Seismic network codeExample: AV
string
required
Station codeExample: CLNE
string
required
Channel codeExample: BHZ
string
required
Start date for query range (inclusive)Format: YYYYMMDD
Example: 20260410 = April 10, 2026
string
required
End date for query range (inclusive)Format: YYYYMMDD
Example: 20260412 = April 12, 2026

Response Format

Response Fields

array
required
Array containing one RSAM series object for the requested channel
string
required
Start date echoed from your query (YYYYMMDD)
string
required
End date echoed from your query (YYYYMMDD)
object
required
Echo of all query parameters for debugging

GET /api/seismic/sites

Returns all distinct network/station/location/channel combinations that have RSAM data. Use this to discover what data is available before querying. Rate limit: 60 requests per minute

Response Format

Response Fields

array
required
List of available channel combinations
integer
required
Total number of distinct channels returned

GET /api/seismic/dates

Returns a list of dates (UTC) that have RSAM data for the requested network/station/channel. Use this to populate date pickers or validate date availability before querying. Rate limit: 60 requests per minute

Parameters

string
required
Seismic network code (e.g. AV)
string
required
Station code (e.g. CLNE)
string
required
Channel code (e.g. BHZ)

Response Format

Response Fields

array
required
List of available dates in YYYY-MM-DD format, ordered newest first
string
required
Network code echoed from your query
string
required
Station code echoed from your query
string
required
Channel code echoed from your query

GET /api/seismic/rsam/latest

Returns the most recent available RSAM date for every network/station/location/channel combination. Useful for dashboards and monitoring views. Rate limit: 60 requests per minute

Response Format

Response Fields

array
required
List of channels with their most recent data date
integer
required
Total number of channels returned

Example Requests

Discover Available Data

Query RSAM Time-series


Code Examples

JavaScript/TypeScript

Python


Handling Rate Limits

The /api/seismic/rsam endpoint limits requests to 100 per minute per IP address. Helper endpoints (/sites, /dates, /rsam/latest) are limited to 60 per minute.

Error Responses


Rate Limits


Need Help?

Query Imagery

Query infrared and visible volcano imagery

Contact Support

Questions or issues? Reach out to our team