query: Query station metadata

API: earthscope.org:earthscopeiris-seismic-web-services
Endpoint: /station/1/query
Response format: text/plain
Auth: unknown
Method: GET
Last Status: 200
Latency: 818ms

Description

Returns seismic station metadata including station codes, network affiliations, channel information, instrument types, coordinates, elevation, and operational time periods. Use this to discover available stations for data requests.

From spec: Search for seismic station metadata including location, channels, and instrument response information.

Usage Tips

- Network codes: IU (Global Seismic Network), II (IRIS/IDA), US (USGS networks), etc. - Wildcards supported: * for any characters, ? for single character - Use format=xml for full StationXML with instrument response - Use format=text for simple tabular output - Specify time range to get stations active during a period

Parameters (27)

channel (string, query, optional)

Select one or more SEED channel codes (e.g., BHZ, HHZ). Accepts wildcards and lists.

endafter (string, query, optional)

Limit to stations ending after the specified time

endbefore (string, query, optional)

Limit to stations ending before the specified time

endtime (string, query, optional)

Limit to events/stations/data on or before the specified end time (ISO 8601 format)

format (string, query, optional, default: xml)

Output format for station metadata

Constraints: {'enum': ['xml', 'text', 'geocsv']}

includeavailability (boolean, query, optional, default: False)

Include data availability information

includecomments (boolean, query, optional, default: True)

Include station comments in results

includerestricted (boolean, query, optional, default: True)

Include restricted stations in results

latitude (number, query, optional, default: 0)

Central latitude point for radial search (degrees)

Constraints: {'minimum': -90, 'maximum': 90}

level (string, query, optional, default: station)

Level of detail in response: network, station, channel, or response

Constraints: {'enum': ['network', 'station', 'channel', 'response']}

location (string, query, optional)

Select one or more SEED location identifiers. Accepts wildcards and lists. Use -- for blank locations.

longitude (number, query, optional, default: 0)

Central longitude point for radial search (degrees)

Constraints: {'minimum': -180, 'maximum': 180}

matchtimeseries (boolean, query, optional, default: False)

Limit metadata to stations with available time series data

maxlatitude (number, query, optional, default: 90.0)

Northern boundary for rectangular search (degrees)

Constraints: {'minimum': -90, 'maximum': 90}

maxlongitude (number, query, optional, default: 180.0)

Eastern boundary for rectangular search (degrees)

Constraints: {'minimum': -180, 'maximum': 180}

maxradius (number, query, optional, default: 180)

Maximum distance from the geographic point (degrees)

Constraints: {'minimum': 0, 'maximum': 180}

minlatitude (number, query, optional, default: -90.0)

Southern boundary for rectangular search (degrees)

Constraints: {'minimum': -90, 'maximum': 90}

minlongitude (number, query, optional, default: -180.0)

Western boundary for rectangular search (degrees)

Constraints: {'minimum': -180, 'maximum': 180}

minradius (number, query, optional, default: 0)

Minimum distance from the geographic point (degrees)

Constraints: {'minimum': 0, 'maximum': 180}

network (string, query, optional)

Select one or more network codes. Accepts wildcards (? and *) and comma-separated lists.

nodata (integer, query, optional, default: 204)

Specify which HTTP status code is returned when no data is found

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

sensor (string, query, optional)

Select matching sensor descriptions

startafter (string, query, optional)

Limit to stations starting after the specified time

startbefore (string, query, optional)

Limit to stations starting before the specified time

starttime (string, query, optional)

Limit to events/stations/data on or after the specified start time (ISO 8601 format)

station (string, query, optional)

Select one or more SEED station codes. Accepts wildcards and lists.

updatedafter (string, query, optional)

Limit to events/stations updated after the specified time

Examples (2)

Query GSN station metadata doc_extracted

Demonstrates querying station metadata for the IU network (IRIS/USGS Global Seismographic Network) at station level detail

curl 'https://service.earthscope.org/fdsnws/station/1/query?net=IU&format=text&level=station'
import requests

resp = requests.get(
    "https://service.earthscope.org/fdsnws/station/1/query",
    params={
        'net': 'IU',
        'format': 'text',
        'level': 'station',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("earthscope")
result = api.fetch("station/1/query", net="IU", format="text", level="station")

for item in result:
    print(item)
const resp = await fetch("https://service.earthscope.org/fdsnws/station/1/query?net=IU&format=text&level=station");
const data = await resp.json();
Query ANMO station channel information doc_extracted

Retrieves detailed channel metadata for a specific station including instrument types, sampling rates, and orientation

curl 'https://service.earthscope.org/fdsnws/station/1/query?net=IU&sta=ANMO&level=channel&format=text'
import requests

resp = requests.get(
    "https://service.earthscope.org/fdsnws/station/1/query",
    params={
        'net': 'IU',
        'sta': 'ANMO',
        'level': 'channel',
        'format': 'text',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("earthscope")
result = api.fetch("station/1/query", net="IU", sta="ANMO", level="channel", format="text")

for item in result:
    print(item)
const resp = await fetch("https://service.earthscope.org/fdsnws/station/1/query?net=IU&sta=ANMO&level=channel&format=text");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 16:48:23.209200 200 818ms
2026-04-16 03:52:34.534384 200 1072ms
2026-04-16 01:45:40.926038 200 1002ms
2026-04-15 01:32:47.849142 200 1645ms
2026-04-15 01:31:11.067170 200 1458ms
2026-04-14 02:59:35.189760 200 1153ms
2026-04-14 01:24:57.325289 200 1097ms
2026-04-12 13:59:34.577663 200 902ms
2026-04-12 13:28:02.431711 200 1084ms