Get Latest Initial Time | Get Available Time range | Get Colormap | Show User Statistics

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?source=<model>&valid_date=<validdatetime>&parameters=<parameter_list>

https://api.meteomatics.com/get_init_date?source=ecmwf-ifs&valid_date=2025-07-02T19: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. This can happen in the following three cases: First, if the get_init_date query is performed on validdates that are more than 1 day in the past. Second, if the get_init_date query is performed on validdates where the model data is not (yet) available. Third, if the get_init_date query is performed on non-native validdates, e.g. in higher resolution than what is natively available. For all cases 00-00-00T00:00:00Z is returned.

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?source=<model>&parameters=<parameter_list>

Example: https://api.meteomatics.com/get_time_range?source=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

Show User Statistics

You can check how many queries you already sent and how your limits are defined by calling https://api.meteomatics.com/user_stats

This is also available in a machine readable format: https://api.meteomatics.com/user_stats_json