EarthScope’s fdsnws-dataselect web service, the primary source of miniSEED data from our seismological repository, has moved from service.iris.edu to service.earthscope.org as part of our cloud transition.
Details are below and documented on the service documentation page:
https://service.earthscope.org/fdsnws/dataselect/1
We’ve worked to make this transition seamless, but if you encounter issues please contact help@earthscope.org.
Action required for restricted data users: You will need new credentials. Visit https://www.earthscope.org/user, create an account (if you do not already have one), then:
- navigate to the Credentials tab
- click “REVEAL MY CREDENTIALS,” and then “CREATE FDSNWS CREDENTIALS” if none exist. These credentials are specific to you and should be kept private.
Redirects from the old service to the new
The old service location (at service.iris.edu) continues to operate, but instead of providing data redirects to the new location. The vast majority of web software follow these redirects automatically or can be configured to do so.
New HTTPS (TLS v1.2+) requirement
The service now requires secure HTTPS, specifically TLS 1.2 or later. Requests to the un-secure HTTP endpoint will be redirected to the HTTPS endpoint according to current best practices.
Some older software may not follow redirects from unsecure HTTP to secure HTTPS. Configure the software, if possible, to use the direct URL to the service https://service.earthscope.org/fdsnws/dataselect/1
Some older software may not support TLS 1.2+. As this standard was defined in 2008 and became default on most client and server software by 2016, we do not anticipate this causing many problems.
More details for client developers and power users
Changes in the new service:
- Some output formats are not yet supported: SAC and text. These will be added later.
- The following parameters are being permanently retired: quality, minimumlength, longestonly, repository, szsrecs.
- With the removal of the szsrecs parameter the service will no longer remove zero-sample records (as was the previous default), which matches the behavior of all other data center implementations.
- There are limits on the volume of data that will be returned. We recommend limiting requests to one station for a 24-hour period at the most.
- Some HTTP response codes for errors have changed to be more precise, but they remain broadly recognized codes.
Please reach out to help@earthscope.org if you have any questions or run into trouble with this new service.