> ## Documentation Index
> Fetch the complete documentation index at: https://arnaud.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# About the Current Weather Data API

> Understand how the Current Weather Data API works and what it returns.

## Overview

The Current Weather Data API lets you retrieve real-time weather data for a specific location.

You can use it to:

* Get temperature, humidity, pressure, and wind data
* Retrieve current weather conditions (for example, rain or clear sky)
* Access optional data such as precipitation or wind gusts when available

The API aggregates data from multiple sources, including weather models, satellites, radars, and weather stations.

Responses are returned in JSON by default.

## Base URL

All endpoints use the following base URL:

```text theme={null}
https://api.openweathermap.org/data/2.5
```

## Request basics

A typical request requires:

* A location (`lat` and `lon` are recommended)
* Your API key (`appid`)
* Optional parameters such as `units`

Example:

```bash theme={null}
curl "https://api.openweathermap.org/data/2.5/weather?lat=48.85&lon=2.35&units=metric&appid=YOUR_API_KEY"
```

By default, temperature is returned in Kelvin. Use `units=metric` or `units=imperial` to control the output.

## Response behavior

The response structure is mostly stable, but some fields are optional:

* `rain` and `snow` only appear when relevant
* `wind.gust` is not always present

Always handle missing fields in your integration.