Humidity API Parameters

Instantaneous Relative Humidity

Gives the instantaneous value of the relative humidity in percent at the indicated level above ground or pressure level. Standard height for surface relative humidity is 2m.

relative_humidity_<level>:<unit>

Available levels (global): 2m - 20000m (continuously), 1000hPa, 975hPa, 950hPa, 925hPa, 900hPa, 875hPa, 850hPa, 825hPa, 800hPa, 775hPa, 750hPa, 700hPa, 650hPa, 600hPa, 550hPa, 500hPa, 450hPa, 400hPa, 350hPa, 300hPa, 250hPa, 200hPa, 150hPa, 100hPa, 70hPa, 50hPa, 10hPa

Available flight levels: FL10 - FL605 (continuously)

Available units: p

Examples

Create a time series of relative humidity in % at different altitudes for Paris:
https://api.meteomatics.com/2025-07-10T00:00:00Z--2025-07-13T00:00:00Z:PT1H/relative_humidity_2m:p,relative_humidity_20m:p,relative_humidity_200m:p,relative_humidity_500m:p,relative_humidity_700hPa:p/48.8566,2.3522/html
Create an HTML map for the relative humidity at 2 meters over Europe.
https://api.meteomatics.com/now/relative_humidity_2m:p/europe:0.1,0.1/html_map

Here is an example for the JSON format:
https://api.meteomatics.com/2025-07-10T00:00:00ZP1D:PT3H/relative_humidity_1000hPa:p/48.8566,2.3522/json

{"version":"3.0","user":"api-test","dateGenerated":"2018-02-14T12:35:19Z","status":"OK","data":
[{"parameter":"relative_humidity_1000hPa:p","coordinates":[{"lat":47.4122,"lon":9.34065,"dates":
[{"date":"2018-02-05T00:00:00Z","value":67.5},{"date":"2018-02-05T03:00:00Z","value":79.4},
{"date":"2018-02-05T06:00:00Z","value":81.8},{"date":"2018-02-05T09:00:00Z","value":89.3},
{"date":"2018-02-05T12:00:00Z","value":85.8},{"date":"2018-02-05T15:00:00Z","value":78.9},
{"date":"2018-02-05T18:00:00Z","value":96.1},{"date":"2018-02-05T21:00:00Z","value":94.9},
{"date":"2018-02-06T00:00:00Z","value":98.2}]}]}]}

Interval Values of Relative Humidity

Gives the mean, maximum or minimum relative humidity at the indicated level over the indicated duration. Standard height for surface relative humidity is 2m.

relative_humidity_<measure>_<level>_<interval>:p

Available flight levels: FL10 - FL605 (continuously)

Available measures: mean, min, max

Available intervals: 1h, 2h, 3h, 6h, 12h, 24h

Available units: p

Examples

Create a time series for the maximum relative humidity at different altitudes for Los Angeles using 3 hour intervals.
Current situation:
https://api.meteomatics.com/2025-07-10T00:00:00Z--2025-07-13T00:00:00Z:PT3H/relative_humidity_max_2m_3h:p,relative_humidity_max_100m_3h:p,relative_humidity_max_850hPa_3h:p/34.0522,118.2437/html?source=mix

Mean Relative Humidity over the Last 10 Years

Gives the mean relative humidity 2 m above ground over the last 10 years on a certain date at a specific location.

relative_humidity_2m_10y_mean:p

Examples:

Compare the mean relative humidity of the last ten years with the relative humidity of 2022.

Current situation:
https://api.meteomatics.com/2025-07-10T12:00:00ZP100D:P2D/relative_humidity_2m_10y_mean:p,relative_humidity_2m:p/50,10/html

The relative humidity in winter compared to the 10 years mean:

validdate;relative_humidity_2m_10y_mean:p;relative_humidity_2m:p
2021-10-01T12:00:00Z;58.7;57.3
2021-11-01T12:00:00Z;77.1;87.6
2021-12-01T12:00:00Z;83.0;87.8
2022-01-01T12:00:00Z;86.3;88.9
2022-02-01T12:00:00Z;78.4;82.2

Current situation:
https://api.meteomatics.com/2025-07-10T12:00:00ZP4M:P1M/relative_humidity_2m_10y_mean:p,relative_humidity_2m:p/50,10/csv

Absolute Humidity

Gives the absolute humidity at 2m in g/m^3. Note: the absolute humidity is only available at 2m.

absolute_humidity_2m:gm3

Examples

Create a time series plot of absolute humidity for Paris.
https://api.meteomatics.com/2025-07-10T00:00:00Z--2025-07-13T00:00:00Z:PT1H/absolute_humidity_2m:gm3/48.8566,2.3522/html

Water Vapor Mixing Ratio

Gives the mixing ratio of water vapor and dry air at the indicated level in kg water vapor per kg dry air.

mixing_ratio_<level>:kgkg

Available levels (global): 1000hPa, 975hPa, 950hPa, 925hPa, 900hPa, 875hPa, 850hPa, 825hPa, 800hPa, 775hPa, 750hPa, 700hPa, 650hPa, 600hPa, 550hPa, 500hPa, 450hPa, 400hPa, 350hPa, 300hPa, 250hPa, 200hPa, 150hPa, 100hPa, 70hPa, 50hPa

Available flight levels: FL10 - FL605 (continuously)

Examples

Query the current mixing ratio:
https://api.meteomatics.com/2025-07-10T00:00:00Z--2025-07-13T00:00:00Z:PT1H/mixing_ratio_700hPa:kgkg/47.4245,9.3767/html?source=mix

Water Vapor Pressure Deficit

The instantaneous water vapor pressure deficit at 2m measures the difference between saturation and the current amount of moisture in the air in terms of pressure. It depends on temperature and relative humidity.

vapor_pressure_deficit_2m:hPa

For the water vapor pressure deficit it is also possible to get the mean, maximum or minimum at 2m over the indicated time interval.

vapor_pressure_deficit_<measure>_2m_<interval>:hPa

Available measures: mean, min, max

Available intervals: 1h, 2h, 3h, 6h, 12h, 24h

Examples

Create a time series for the instantaneous water vapor pressure deficit in St.Gallen for two days in July 2024.
Current situation:
https://api.meteomatics.com/2025-07-10T00:00:00Z--2025-07-13T00:00:00Z:PT3H/vapor_pressure_deficit_2m:hPa/47.4245,9.3767/html?source=mix