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
| Field | Value |
|---|---|
| Volcano | Cleveland |
| Network | AV |
| Station | Channels |
|---|---|
CLCL | BHE, BHN, BHZ |
CLCO | BHE, BHN, BHZ |
CLES | BHE, BHN, BHZ |
CLNE | BHE, BHN, BHZ |
CLSF | BHE, BHN, BHZ |
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/seismic/sites | List all available network/station/channel combinations |
GET | /api/seismic/dates | List dates with RSAM data for a specific channel |
GET | /api/seismic/rsam/latest | Most recent RSAM entry per channel |
GET | /api/seismic/rsam | RSAM time-series for a channel over a date range |
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
Seismic network codeExample:
AVStation codeExample:
CLNEChannel codeExample:
BHZStart date for query range (inclusive)Format:
Example:
YYYYMMDDExample:
20260410 = April 10, 2026End date for query range (inclusive)Format:
Example:
YYYYMMDDExample:
20260412 = April 12, 2026Response Format
Response Fields
Array containing one RSAM series object for the requested channel
Start date echoed from your query (
YYYYMMDD)End date echoed from your query (
YYYYMMDD)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
List of available channel combinations
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
Seismic network code (e.g.
AV)Station code (e.g.
CLNE)Channel code (e.g.
BHZ)Response Format
Response Fields
List of available dates in
YYYY-MM-DD format, ordered newest firstNetwork code echoed from your query
Station code echoed from your query
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
List of channels with their most recent data date
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
| Endpoint | Rate Limit | Window |
|---|---|---|
/api/seismic/rsam | 100 requests | per minute |
/api/seismic/sites | 60 requests | per minute |
/api/seismic/dates | 60 requests | per minute |
/api/seismic/rsam/latest | 60 requests | per minute |
Need Help?
Query Imagery
Query infrared and visible volcano imagery
Contact Support
Questions or issues? Reach out to our team

