GET /irisws/fedcatalog/1/query

iris.edu:iris-web-services

Summary: Federated catalog query
Operation ID: getFedCatalog
Auth: none

Query a federated catalog across multiple seismic data centers. Unlike the standard station service which only searches IRIS data, this endpoint queries multiple FDSN data centers simultaneously to find stations and data across the global seismic network. Returns channel metadata and availability information from federated sources including IRIS, ORFEUS, GEOFON, and others. Use this when you need to discover seismic stations worldwide regardless of which data center hosts the data. The response combines station information with data availability, making it ideal for planning multi-network data requests.

Original spec description

Query across multiple data centers for station metadata. Returns combined results from federated data centers.

Usage Tips

- This endpoint queries multiple data centers - responses may be slower than station service - Supports the same query parameters as the station service (network, station, channel, geographic) - The format=text option returns a simple table listing data center, network, station, and availability - Use for comprehensive station discovery spanning international networks - Each result includes the data center code (e.g., IRIS, ORFEUS) so you know where to request data - The federated search is ideal for finding data in your region of interest across all available networks

Parameters (12)

channel (string, query, optional)

Channel code(s)

endtime (string, query, optional)

End time (ISO 8601)

format (string, query, optional)

Output format

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

level (string, query, optional)

Level of detail

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

location (string, query, optional)

Location code(s). Use -- for blank.

maxlatitude (number, query, optional)

Maximum latitude

maxlongitude (number, query, optional)

Maximum longitude

minlatitude (number, query, optional)

Minimum latitude

minlongitude (number, query, optional)

Minimum longitude

network (string, query, optional)

Network code(s). Accepts wildcards and comma-separated lists.

starttime (string, query, optional)

Start time (ISO 8601)

station (string, query, optional)

Station code(s)

Examples (4)

TitleTypeURLAction
Query by network and station codes curl https://service.iris.edu/irisws/fedcatalog/1/query?net=IU&sta=ANMO&cha=BHZ&start=2024-01-01T00:00:00&end=2024-01-02T00:00:00&format=text
Geographic bounding box search curl https://service.iris.edu/irisws/fedcatalog/1/query?minlat=32&maxlat=42&minlon=-125&maxlon=-115&cha=HHZ&start=2024-01-01T00:00:00&end=2024-02-01T00:00:00&format=text
Radius search around geographic point curl https://service.iris.edu/irisws/fedcatalog/1/query?lat=39&lon=-98&maxradius=10&net=US&cha=BHZ&start=2024-01-01T00:00:00&end=2024-01-02T00:00:00&format=text
Federated catalog query openapi-spec https://service.iris.edu/irisws/fedcatalog/1/query?network=IU&format=text&level=channel

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:24:56.190128 406 712ms
2026-03-23 10:22:40.643272 406 845ms
2026-03-23 09:22:56.845621 406 706ms
2026-03-23 09:07:00.677539 406 705ms