Current Weather

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.

Request Parameters

  • 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.

Search Methods

Use one location method per request:

  • slug
  • lat + lon
  • ip

Authentication is required for all methods: use X-token header or key query parameter.

Request Format

GET /v2/current/?{location_query}
X-token: TOKEN
or
GET /v2/current/?{location_query}&key=TOKEN
Query optionRequired paramsExample query string
By slugslug?slug=united-kingdom-london
By coordslat, lon?lat=51.5072&lon=-0.1275
By IPip?ip=8.8.8.8

Minimal Examples

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'

Description of the Response Structure

All successful API responses return with an HTTP status of 200 OK and contain data in JSON format.

FieldDescriptionFormat
placeLocality.Object
currentCurrent weather.Object
astronomyAstronomy.Object

Object place

FieldDescriptionFormat
countryCountry code.String
timezone_offsetTimezone offset from UTC in seconds.Number
latitudeLongitude.Number
longitudeLatitude.Number
city_nameName of the locality.String
country_nameCountry name.String
region_nameRegion name.String

Object current

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.

FieldDescriptionFormat
dateDate.String
temperature_airAir temperature.Number
temperature_air_feels_likeAir temperature feels like.Number
descriptionDescription of the current weather.String
precipitationPrecipitation.Object
cloudnessCloudiness.Object
iconIcon.Object
uvindexUV index.Object
pressurePressure.Number
humidityHumidity.Number
visibilityVisibility.Number
windWind.Object

Object precipitation

FieldDescriptionFormat
typeType of precipitation. Possible values:
none – no precipitation.
rain – rain.
rain-snow – rain with snow.
snow – snow.
String
valAmount of precipitation in millimeters.Number | Null

Object cloudness

FieldDescriptionFormat
typeCloudiness. Possible values:
clear – clear.
partly cloudy – partly cloudy.
cloudy – overcast.
String

Object icon

FieldDescriptionFormat
codeSymbolic code for the weather icon.String
urlURL of the weather icon.String

Object uvindex

FieldDescriptionFormat
valValue.Number
descriptionDescription.String

Object wind

FieldDescriptionFormat
speedThe average wind speed over the past 10 minutes.Number
degreeWind direction in meteorological degrees (0° = North, 90° = East, 180° = South, 270° = West).Number
gustThe maximum wind gust speed recorded over the past 10 minutes.Number

Object astronomy

FieldDescriptionFormat
sunriseSunrise time in UTC format (ISO 8601), indicating the exact moment the day begins.Number
sunsetSunset time in UTC format (ISO 8601), indicating the moment when daylight ends.Number
day_lengthDuration of the daylight in minutes, calculated as the difference between sunset and sunrise.Number
moon_angleThe current angle of the Moon in the sky, measured in degrees (0° to 360°).Number
moon_illuminationThe percentage of the Moon's surface illuminated by the Sun (0% = new moon, 100% = full moon).Number
moon_phase_codeNumeric code for the Moon's phase (0–7).Number
moon_phase_descTextual description of the Moon's phase.string