Veps API version 2025.1

Your source to meteorological and hydrological time series from Met.no, NVE, SMHI and Syke.

And model domain information.

Getting Started | Api Reference (Swagger) | Endpoints | Available time series

Get Time Series Data

https://vepsapi.nve.no/timeseriesdata/read?

Method

GET

Summary

Get time series data

Description

This method provides a unified request - response model for getting time series data from different sources.

Get time series data

Current sources are:

  • Veps database
    • Containing observed and forecast meteorological data from met.no and simulated hydrological data from some models.
  • Hydra database
    • Containing hydrological observations from NVEs network
  • SMHI-Api
    • Containing hydrological and meteorological observations from SMHIs network
  • SYKE-API
    • Containing hydrological observations from SMHIs network

List of available time series are found here

Request for meteorological observations my be spliced with meteorological forecasts, if the reference time is in future.

Request parameters:

Parameter Description Type Default Value Required
Locations The time series id. String Yes
ReferenceTime The time range to get time series for. String Yes
DataSource Where to get time series from. String Yes
Elements The time series parameter. String Yes
Zone If true get zone data, otherwise point data. String enum:
["true", "false"]
Yes
Ensemble If true get ensemble data. String enum:
["true", "false"]
Yes
TimeOffsets Time offsets. String PT6H Yes
TimeResolutions Time resolutions. String P1D Yes
GeneratedTime The generated time range. String 1900-01-01/2100-01-01 No

Response structure

200 - successfull operation

 - locations (array)
	* station_id (string) - Station id
	- elements (array)
		* parameter_name (string) - Parameter name
		* parameter_key (number) - Hydra parameter key
		* method_name (string) - Method name
		* method_key (number) - Hydra method key
		* unit (string) - Unit
		* zone (array) - Array of zone indexes
		* ensemble_member (int) - The ensemble number
		* version_no (int) - For Hydra time series, the version_no used
		- data (array)
			* source (string) - The data source for this sample
			* reference_time (string) - Timestamp
			* quality (int) - Unknown = 0, Uncontrolled = 1, PrimaryControlled = 2, SecondaryControlled = 3
			* values (array) - Array of values

Response data model

Get time series data response

Examples:

/timeseriesdata/read?Locations=6.10.0&ReferenceTime=2020-10-20&DataSource=met_obs_v11&Elements=temperature&Zone=false&Ensemble=false&TimeOffsets=PT6H&TimeResolutions=P1D