The Current Weather section delivers an up‑to‑the‑minute snapshot of atmospheric conditions at any specified location.
Observational data are pulled from a network of ground stations, satellite-derived estimates and high‑resolution
numerical models, then bias‑corrected and spatially interpolated to provide a coherent, real‑time view. Updates occur
every 10–15 minutes (depending on data availability), ensuring you always have the freshest information at hand.
Each parameter is returned as a single “now” value reflecting the latest measurement or short‑term average:
- Temperature, humidity and pressure are instantaneous readings, corrected for known sensor biases.
- Wind speed and direction represent an average over the prior 10 minutes to smooth out gusts while preserving
meaningful trends.
- Precipitation is reported as the accumulated total over the last hour.
slug | lat and lon | ip: Location parameters.unit: Units system for response values. Supported values: metric (default), imperial.X-token or key: Your API token passed in the request header or query string.
Use one location method per request:
Authentication is required for all methods: use X-token header or key query parameter.
GET /v2/current/?{location_query}
X-token: TOKEN
or
GET /v2/current/?{location_query}&key=TOKEN
| Query option | Required params | Example query string |
|---|
| By slug | slug | ?slug=united-kingdom-london |
| By coords | lat, lon | ?lat=51.5072&lon=-0.1275 |
| By IP | ip | ?ip=8.8.8.8 |
curl --location 'https://api.meteoflow.com/v2/current/?slug=united-kingdom-london' \
--header 'X-token: TOKEN'
curl --location 'https://api.meteoflow.com/v2/current/?lat=51.5072&lon=-0.1275&key=TOKEN'
curl --location 'https://api.meteoflow.com/v2/current/?ip=8.8.8.8' \
--header 'X-token: TOKEN'
Available slug values are listed in the Geography API section.
All successful API responses return with an HTTP status of 200 OK and contain data in JSON format.
| Field | Description | Format |
|---|
country | Country code. | String |
timezone_offset | Timezone offset from UTC in seconds. | Number |
latitude | Longitude. | Number |
longitude | Latitude. | Number |
city_name | Name of the locality. | String |
country_name | Country name. | String |
region_name | Region name. | String |
The current object provides a real‑time snapshot of weather conditions at a given location, including key parameters
such as temperature, humidity, atmospheric pressure, wind speed and direction, precipitation rate, and other indicators
reflecting the present moment.
| Field | Description | Format |
|---|
date | Date. | String |
temperature_air | Air temperature. | Number |
temperature_air_feels_like | Air temperature feels like. | Number |
description | Description of the current weather. | String |
precipitation | Precipitation. | Object |
cloudness | Cloudiness. | Object |
icon | Icon. | Object |
uvindex | UV index. | Object |
pressure | Pressure. | Number |
humidity | Humidity. | Number |
visibility | Visibility. | Number |
wind | Wind. | Object |
| Field | Description | Format |
|---|
type | Type of precipitation. Possible values:
none – no precipitation.
rain – rain.
rain-snow – rain with snow.
snow – snow. | String |
val | Amount of precipitation in millimeters. | Number | Null |
| Field | Description | Format |
|---|
type | Cloudiness. Possible values:
clear – clear.
partly cloudy – partly cloudy.
cloudy – overcast. | String |
| Field | Description | Format |
|---|
code | Symbolic code for the weather icon. | String |
url | URL of the weather icon. | String |
| Field | Description | Format |
|---|
val | Value. | Number |
description | Description. | String |
| Field | Description | Format |
|---|
speed | The average wind speed over the past 10 minutes. | Number |
degree | Wind direction in meteorological degrees (0° = North, 90° = East, 180° = South, 270° = West). | Number |
gust | The maximum wind gust speed recorded over the past 10 minutes. | Number |
| Field | Description | Format |
|---|
sunrise | Sunrise time in UTC format (ISO 8601), indicating the exact moment the day begins. | Number |
sunset | Sunset time in UTC format (ISO 8601), indicating the moment when daylight ends. | Number |
day_length | Duration of the daylight in minutes, calculated as the difference between sunset and sunrise. | Number |
moon_angle | The current angle of the Moon in the sky, measured in degrees (0° to 360°). | Number |
moon_illumination | The percentage of the Moon's surface illuminated by the Sun (0% = new moon, 100% = full moon). | Number |
moon_phase_code | Numeric code for the Moon's phase (0–7). | Number |
moon_phase_desc | Textual description of the Moon's phase. | string |