Get current weather

GET
https://api.cirrosense.com/current

Returns current weather conditions for a given location

Query Parameters

  • key

    string
    required

    Your Cirrosense API key

  • lat

    number

    Latitude of the location. Required if place is not provided

    Min: -90Max: 90

  • lon

    number

    Longitude of the location. Required if place is not provided

    Min: -180Max: 180

  • place

    string

    Place name to look up. Used as an alternative to lat/lon

  • units

    string

    Unit system for response values

    Allowed values:
    • metric
    • imperial

    Default: metric

Response Codes

Status Description Schema
200 Success Current Weather Response
400 Invalid Request ErrorResponse
429 Rate Limit Exceeded ErrorResponse

Example Request

GET /current
curl -G https://api.cirrosense.com/current \
  -d "key=YOUR_CIRROSENSE_API_KEY" \
  -d "lat=40.7128" \
  -d "lon=-74.006" \
  -d "place=New York, NY" \
  -d "units=metric"
Response
{
  "location": {
    "lat": 40.7128,
    "lon": -74.006,
    "name": "New York",
    "admin": "New York",
    "country": "United States",
    "iso2": "US",
    "timezone": "America/New_York"
  },
  "data": {
    "time": "2026-02-20T12:00:00Z",
    "temp": 25.5,
    "feels_like": 22.3,
    "dew": 15.2,
    "humidity": 65,
    "wind_speed": 12.1,
    "wind_gust": 18.5,
    "wind_deg": 270,
    "wind_dir": "N",
    "pressure": 101.33,
    "vis": 24,
    "clouds": 35,
    "pop": 50,
    "precip_amount": 0,
    "precip_type": "rain",
    "description": {
      "code": 520,
      "name": "Rain"
    }
  },
  "units": {
    "temp": "°C",
    "feels_like": "°C",
    "dew": "°C",
    "wind_speed": "km/h",
    "wind_gust": "km/h",
    "pressure": "kPa",
    "vis": "km",
    "rain": "mm",
    "snow": "cm"
  }
}