Query RSAM
Endpoints
Query RSAM
Endpoints for querying seismic RSAM (Real-time Seismic Amplitude Measurement) time-series data
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.Available Stations and Channels
- Cleveland
- Poás
- Villarrica
Endpoints
GET /api/seismic/rsam
Returns a RSAM time-series for the requested channel betweendatefrom and dateto. Both dates are inclusive and results are returned in chronological order.
Parameters
string
required
Seismic network codeExample:
AVstring
required
Station codeExample:
CLNEstring
required
Channel codeExample:
BHZstring
required
Start date for query range (inclusive)Format:
Example:
YYYYMMDDExample:
20260410 = April 10, 2026string
required
End date for query range (inclusive)Format:
Example:
YYYYMMDDExample:
20260412 = April 12, 2026Response 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 minuteResponse 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 minuteParameters
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 firststring
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 minuteResponse 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

