Current Weather
Up-to-the-minute snapshot of atmospheric conditions for a selected location.
GET /v2/current/
Returns current weather and astronomy for the day. You must provide either slug or lat+lon.
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.
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 trends.
- Precipitation is reported as the accumulated total over the last hour.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
slug | string | no | City/location slug. Alternative to lat+lon. |
lat | number (double) | no | Latitude. Used with lon as an alternative to slug. |
lon | number (double) | no | Longitude. Used with lat as an alternative to slug. |
unit | string (metric | imperial) | no | Unit system |
Provide either slug or both lat and lon.
Example
200 Response Schema
Response type: object.
Top-level fields:
| Field | Type | Required | Description |
|---|---|---|---|
place | object | yes | - |
astronomy | object | yes | - |
current | object | yes | - |
place
Location metadata for the requested point: country, coordinates, timezone, and localized names.
| Field | Type | Required | Description |
|---|---|---|---|
country | string | yes | - |
timezone_offset | integer | yes | - |
latitude | number (double) | yes | - |
longitude | number (double) | yes | - |
city_name | string | yes | - |
country_name | string | yes | - |
region_name | string | null | no | - |
astronomy
Astronomical data for the current date at this location.
| Field | Type | Required | Description |
|---|---|---|---|
date | string (date) | yes | - |
sunrise | string (date-time) | yes | - |
sunset | string (date-time) | yes | - |
day_length | integer (int64) | yes | - |
moon_angle | integer | yes | - |
moon_illumination | integer | yes | - |
moon_phase_code | integer | yes | - |
current
Current weather measurements and derived indicators for the location.
| Field | Type | Required | Description |
|---|---|---|---|
date | string (date-time) | yes | - |
temperature_air | number (double) | yes | - |
temperature_air_feels_like | number (float) | yes | - |
description | string | yes | - |
precipitation | object | yes | - |
cloudiness | object | yes | - |
icon | object | yes | - |
uvindex | object | yes | - |
pressure | integer | yes | - |
humidity | integer | yes | - |
visibility | integer | null | no | - |
wind | object | yes | - |
current.precipitation
Precipitation type and intensity for the current moment.
| Field | Type | Required | Description |
|---|---|---|---|
type | string (none | rain | snow) | yes | - |
mm | number (float) | null | yes | - |
current.cloudiness
Cloud cover classification at the current time.
| Field | Type | Required | Description |
|---|---|---|---|
type | string (clear | partly cloudy | cloudy) | yes | - |
current.icon
Icon metadata for UI display of the current weather state.
| Field | Type | Required | Description |
|---|---|---|---|
code | string | yes | - |
url | string | yes | - |
current.uvindex
Current UV index value and qualitative risk description.
| Field | Type | Required | Description |
|---|---|---|---|
val | integer | yes | - |
description | string (low | moderate | high | very high | extreme) | yes | - |
current.wind
Wind speed, direction, and gusts at the current time.
| Field | Type | Required | Description |
|---|---|---|---|
speed | number (double) | yes | - |
degree | integer | yes | - |
gust | number (double) | yes | - |
Error Responses
Standard API error model for validation, not found, and server errors.
| Status | Description |
|---|---|
400 | Invalid request parameters |
404 | Data/route not found |
500 | Internal server error |
Error object fields:
| Field | Type | Required | Description |
|---|---|---|---|
status_code | integer | yes | - |
message | string | yes | - |
detail | string | yes | - |