SAGE: IRISWS: Nrl: Docs: v. 1: Builder

Service interface URL Builder Help Revisions

Use this form to build a URL to the nrl web service. Notice that as you edit the form, the link is automatically updated.

Usage

You can also browse the NRL catalog contents here.

Request Type

Query Method:

Selection

Select by

Instconfig Element/Manufacturer/Model

Instconfig:

Instrument configuration code

Element:

Manufacturer:

Model:

Level:

Updated Since:

Options

Format:

Epoch

Network:

Station:

Location:

Channel:

Start Time:

End Time:

Click the link:

What is the nodata=404 URL parameter?

parameter	examples	notes	default	element
Common options (`/catalog`, `/combine` and `/prefix-lookup` query methods)
nodata	404	Specify which HTTP status code is returned when no data is found.¹	204	204 or 404
/catalog options (also takes Common options as described above)
element	sensor	Filter by element type. Current elements include `sensor`, `datalogger`, `integrated` and `soh`. Accepts wildcards and lists.	None	string
man[ufacturer]	EQMet	Filter by manufacturer. Accepts wildcards and lists.	None	string
model	CMG*	Filter by model. Accepts wildcards and lists.	None	string
level	model	Specify the level of desired detail. Accepted values are `element`, `manufacturer`, `model` and `configuration`.	configuration	string
updatedsince	2021-01-01	Filter for information updated on or since the beginning day boundary of this date (UTC).	None	date
format	xml	Specify output format. Accepted values are `json`, `xml`, and `text`. More Help	json	string
/combine options (also takes Common options)
instconfig	sensor_CEADASE_CPHM-500_LP1_PG8_SG2250_STgroundVel: datalogger_EQMet_SMA_PG1_FR50	Specify the instrument configuration(s) for the response file(s) requested. Separating two instrument configuration strings with a comma (`,`) returns individual responses for each instrument in the list. Joining multiple instrument configuration strings with a colon (`:`) returns a single response file that cascades each joined instrument in order. Accepts lists when format is specified as a .zip file, but not wildcards. NOTE: To receive a zip archive of the full NRL in a directory structure similar to the original NRL, specify `full_NRL_v2_zip` for this parameter and choose either resp.zip or stationxml.zip as the `format`: curl -JLO ‘http://service.iris.edu/irisws/nrl/1/combine?nodata=404&instconfig=full_NRL_v2_zip&format=resp.zip’	None	string
element	sensor	Filter by element type. Current elements include `sensor`, `datalogger`, `integrated` and `soh`. Accepts wildcards and lists.	None	string
man[ufacturer]	EQMet	Filter by manufacturer. Accepts wildcards and lists.	None	string
model	CMG*	Filter by model. Accepts wildcards and lists.	None	string
updatedsince	2021-01-01	Filter for information updated on or since the beginning day boundary of this date (UTC).	None	date
net[work]	IU	Specify a network code to include in the response file.	XX	string
sta[tion]	ANMO	Specify a station code to include in the response file.	YY	string
loc[ation]	00	Specify a location code to include in the response file.	00	string
cha[nnel]	BHZ	Specify a channel code to include in the response file.	ZZZ	string
starttime	2020-01-01[T00:00:00.000000]	Specify an epoch start date to include in the response file.	1970-01-01T00:00:00Z	date/time
endtime	2021-01-01[T00:00:00.000000]	Specify an epoch end date to include in the response file.	None	date/time
format	stationxml-resp	Specify output format. Accepted values are `stationxml`, `stationxml-resp`, `resp`, `stationxml.zip`, `stationxml-resp.zip`, `resp.zip`. More Help	stationxml	string
admin		For internal use during testing.	None	string
/prefix-lookup options (also takes Common options)
format	xml	Specify output format. Accepted values are `json`, `xml`, and `text`. More Help	json	string

¹ By default, the service returns a HTTP response code 204, which means the request was successful, but no data (no content) was retrieved. However, because there was no “error”, no error message is generated and it may appear that the browser did nothing. To force an empty query response to display an error message, add nodata=404 to the URL.

Problems with this service?

Please send an email report of which service you were using, your URL query, and any error feedback to:
[email protected]
We will address your issue as soon as possible.

URL Builder: nrl v.1

Problems with this service?