Create free API test account
Get Latest Initial Time | Get Available Time range | Get Colormap

Meta Requests

Get Latest Initial Time

You can find out when the data was computed (which model run the data originated from) using this query:

https://api.meteomatics.com/get_init_date?model=<model>&valid_date=<validdatetime>&parameters=<parameter_list>
https://api.meteomatics.com/get_init_date?model=ecmwf-ifs&valid_date=2022-06-29T19:00:00ZP1D:PT6H&parameters=t_2m:C,relative_humidity_2m:p

Reply: 
validdate;initdate_t_2m:sql;initdate_relative_humidity_2m:sql
2017-06-22T19:00:00Z;2017-06-21T12:00:00Z;2017-06-21T12:00:00Z
2017-06-23T01:00:00Z;2017-06-21T12:00:00Z;2017-06-21T12:00:00Z
2017-06-23T07:00:00Z;2017-06-21T12:00:00Z;2017-06-21T12:00:00Z
2017-06-23T13:00:00Z;2017-06-21T12:00:00Z;2017-06-21T12:00:00Z
2017-06-23T19:00:00Z;2017-06-21T12:00:00Z;2017-06-21T12:00:00Z
If a value of a certain time step can not be assigned to an init date, the init date is represented as 00-00-00T00:00:00Z.

Get Available Time Range

The valid dates that are available within the API can be queried with using: 
https://api.meteomatics.com/get_time_range?model=<model>&parameters=<parameter_list>

Example: https://api.meteomatics.com/get_time_range?model=ecmwf-ifs&parameters=global_rad:W,t_2m:C

Response:
parameter;min_date;max_date
global_rad:W;2013-12-30T00:00:00Z;2017-07-01T12:00:00Z
t_2m:C;2013-12-30T00:00:00Z;2017-07-01T12:00:00Z

Get Colormaps

The colormaps described here can be queried by using:

https://api.meteomatics.com/get_colormap?parameter=<parameter>&style=<style>&format=<format>

The parameters of a get_colormap request a as follows:

Option Description Example
<parameter> A weather parameter. Please refer to Available Parameters for a sorted list of valid parameters. fresh_snow:cm
<style> The colormap you want to get the numerical values for. The list of available colormaps is here. If style= is omitted from a get_colormap request, then a default value for <style> is provided depending on the requested parameter. jet_segmented
<format> The output data format. CSV is the only available output format. csv

Example of a get_colormap request with all the three parameters explicitly defined:
https://api.meteomatics.com/get_colormap?parameter=fresh_snow:cm&style=jet_segmented&format=csv

Example of a get_colormap request with only two parameters explicitly defined. In this case,<style> is automatically set to jet:
https://api.meteomatics.com/get_colormap?parameter=fresh_snow:cm&format=csv

Example of generated csv file:

Value;Hex Color
160;#870000FF
156;#9B0F14FF
152;#AC1E32FF
...
12;#1928B9FF
8;#0519A0FF
4;#000A6EFF