1. Return List of Stations

URL:

Returns list of stations referred to as 'model' in other endpoints.

Sample Output:

[
"gits",
"humboldt",
"petermann",
"tunu_n",
"swisscamp_10m_tower",
"swisscamp",
"crawfordpoint",
"nasa_u",
"summit",
"dye2",
"jar1",
"saddle",
"southdome",
"nasa_east",
"nasa_southeast",
"neem",
"east_grip"
]

2. Download NEAD

Click here for information about the NEAD format

URL template with time range: https://www.envidat.ch/data-api//nead/model/timestamp_meaning/nodata/start/end

Example with time range, timestamp meaning 'end' and no data value '' (empty string):

URL template returning all records: https://www.envidat.ch/data-api//nead/model/timestamp_meaning/nodata/

Example returning all records, timestamp meaning 'end' and no data value '' (empty string):

model should correspond to a model name listed at , for example

timestamp_meaning should be end or beginning

• end means that timestamps are at the "end" of a hour long averaging period

• beginning means that timestamps are at the "beginning" of a hour long averaging period

nodata represents "null" values in the database

• means that all "null" values will be "" in the NEAD file

• empty means that all "null" values will be "" (empty strings) in the NEAD file

start is the start date of the dataset

end is the end date of the dataset (exclusive)

• start and end dates must be in in ISO timestamp date format: YYYY-MM-DD ('2019-12-20')

• start date must precede end date

3. Download CSV

URL template: https://www.envidat.ch/data-api//csv/model/parameter/timestamp_meaning/nodata/start/end/

Example with timestamp meaning 'end' and no data value '':

Example returning several parameters with timestamp meaning 'end' and no data value '':

model should correspond to a model name listed at , for example

parameter should be a type of measurement, for example

parameter can also be several types of measurements separated by commas, for example

• Click here for list of parameters

• multiple means that all parameters will be included in the CSV

timestamp_meaning should be end or beginning

• end means that timestamps are at the "end" of a hour long averaging period

• beginning means that timestamps are at the "beginning" of a hour long averaging period

nodata represents "null" values in the database

• means that all "null" values will be "" in the CSV file

• empty means that all "null" values will be "" (empty strings) in the CSV file

start is the start date of the dataset

end is the end date of the dataset (exclusive)

• start and end dates must be in in ISO timestamp date format: YYYY-MM-DD ('2019-12-20')

• start date must precede end date

4. Return JSON Data

URL template: https://www.envidat.ch/data-api//json/model/parameter/start/end/

Example:

Example returning several parameters:

Example returning multiple parameters:
https://www.envidat.ch/data-api//json//multiple/2020-11-04T17:00:00/2020-11-10T00:00:00/

model should correspond to a model name listed at , for example

parameter should be a type of measurement, for example

parameter can also be several types of measurements separated by commas, for example

• Click here for list of parameters

• multiple means that all parameters will be included in the returned JSON data

start is the start date and time of the dataset

end is the end date and time of the dataset

• start date must precede end date

• start and end must be in in ISO timestamp date and time format: YYYY-MM-DDTHH:MM:SS ('2020-10-20T17:00:00)

5. Return Daily Summary JSON Data

URL template: https://www.envidat.ch/data-api//summary/daily/json/model/parameter/start/end/

Example:

Example returning several parameters:

model should correspond to a model name listed at , for example

parameter should be a type of measurement, for example

parameter can also be several types of measurements separated by commas, for example

• Click here for list of parameters

start is the start date of the dataset

end is the end date of the dataset (exclusive)

• start and end dates must be in in ISO timestamp date format: YYYY-MM-DD ('2019-12-20')

• start date must precede end date

Parameters are aggregated daily for the following derived values: minimum ('_min'), maximum ('_max'), and average ('_avg)

'day' values are in "year-"day number" format

'timestamp_first' and 'timestamp_last' are the range of timestamps (inclusive) used for calculating the daily aggregated values

Sample Output:

[
{
day: "2020-308",
timestamp_first: "2020-11-03T00:00:00Z",
timestamp_last: "2020-11-03T23:00:00Z",
_min: -21.93,
_max: -3.15,
_avg: -12.93
},
{
day: "2020-309",
timestamp_first: "2020-11-04T00:00:00Z",
timestamp_last: "2020-11-04T23:00:00Z",
_min: -10.47,
_max: -4.15,
_avg: -7.59
},
{
day: "2020-310",
timestamp_first: "2020-11-05T00:00:00Z",
timestamp_last: "2020-11-05T23:00:00Z",
_min: -20.21,
_max: -10.65,
_avg: -14.39
}
]

6. Download Daily Summary CSV

URL template: https://www.envidat.ch/data-api//summary/daily/csv/model/parameter/timestamp_meaning/nodata/start/end/

Example with timestamp meaning 'end' and no data value '' (empty string):

Example returning several parameters with timestamp meaning 'end' and no data value '' (empty string):

model should correspond to a model name listed at , for example

parameter should be a type of measurement, for example

parameter can also be several types of measurements separated by commas, for example

• Click here for list of parameters

timestamp_meaning should be end or beginning

• end means that timestamps are at the "end" of a hour long averaging period

• beginning means that timestamps are at the "beginning" of a hour long averaging period

nodata represents "null" values in the database

• means that all "null" values will be "" in the CSV file

• empty means that all "null" values will be "" (empty strings) in the CSV file

start is the start date of the dataset

end is the end date of the dataset (exclusive)

• start and end dates must be in in ISO timestamp date format: YYYY-MM-DD ('2019-12-20')

• start date must precede end date

Parameters are aggregated daily for the following derived values: minimum ('_min'), maximum ('_max'), and average ('_avg)

'day' values are in "year-"day number" format

'timestamp_first' and 'timestamp_last' are the range of timestamps (inclusive) used for calculating the daily aggregated values

7. Metadata

Returns metadata for each station including earliest timestamps.

Also returns both earliest and latest timestamps for specified parameters in ISO and UNIX (millisecond) formats.

URL template: https://www.envidat.ch/data-api//metadata/model/parameter/

Example:

Example returning several parameters:

Example returning multiple parameters:
http://www.envidat.ch/data-api//metadata//multiple/

model should correspond to a model name listed at , for example

parameter should be a type of measurement, for example

parameter can also be several types of measurements separated by commas, for example

• Click here for list of parameters

• multiple means that all parameters and their aggregated values will be included in the returned JSON data

---

Parameter List

Parameter	Name	Units
swin	Shortwave Incoming Radiation	W m-2
swout	Shortwave Outgoing Radiation	W m-2
netrad	Net Radiation	W m-2
airtemp1	Thermocouple Air Temperature 1	°C
airtemp2	Thermocouple Air Temperature 2	°C
airtemp_cs500air1	CS500 Air Temperature 1	°C
airtemp_cs500air2	CS500 Air Temperature 2	°C
rh1	Relative Humidity 1	%
rh2	Relative Humidity 2	%
windspeed1	Wind Speed 1	m s-1
windspeed2	Wind Speed 2	m s-1
winddir1	Wind Direction 1	degrees
winddir2	Wind Direction 2	degrees
pressure	Atmospheric Pressure	mb
sh1	Snow Surface Distance 1	m
sh2	Snow Surface Distance 2	m
battvolt	Battery Voltage	V
swin_maximum	Shortwave Incoming Radiation Maximum	W m-2
swin_stdev	Shortwave Incoming Radiation Standard Deviation	W m-2
netrad_stdev	Net Radiation Standard Deviation	W m-2
airtemp1_maximum	Thermocouple Air Temperature 1 Maximum	°C
airtemp2_maximum	Thermocouple Air Temperature 2 Maximum	°C
airtemp1_minimum	Thermocouple Air Temperature 1 Minimum	°C
airtemp2_minimum	Thermocouple Air Temperature 2 Minimum	°C
windspeed_u1_maximum	Wind Speed 1 Maximum	m s-1
windspeed_u2_maximum	Wind Speed 2 Maximum	m s-1
windspeed_u1_stdev	Wind Speed 1 Standard Deviation	m s-1
windspeed_u2_stdev	Wind Speed 2 Standard Deviation	m s-1
reftemp	Reference Temperature	°C