# Examples

**1. find a station**  

[https://toar-data.fz-juelich.de/api/v2/stationmeta/?country=DE,NL&limit=None](https://toar-data.fz-juelich.de/api/v2/stationmeta/?country=DE,NL&limit=None)  
provides all stations from Germany and The Netherlands. 

**2. find all variables**  

From the first command, we found the station Niederzier (next to Jülich Research Centre). Its station code is DENW074.
We now require all time series for this specific station that are stored in the TOAR database:  
[https://toar-data.fz-juelich.de/api/v2/search/?codes=DENW074](https://toar-data.fz-juelich.de/api/v2/search/?codes=DENW074)  
provides all timeseries of station DENW074.

**3. download data**  

From the previous results, we choose the time series of ozone from the `resource_provider`(roles) German Environment Agency (UBA).  
Its id is 18763.  
We want to download all available data in csv format:  
[https://toar-data.fz-juelich.de/api/v2/data/timeseries/18763?format=csv](https://toar-data.fz-juelich.de/api/v2/data/timeseries/18763?format=csv)  
provides all data from time series with id 18763.

**4. Python example**  

[https://toar-data.fz-juelich.de/api/v2/#python-example](https://toar-data.fz-juelich.de/api/v2/#python-example)  
gives an example of how to use the REST service with python.  
Prerequisites are the packages io, json, pandas, and requests.