Get detailed current weather information for a city. | Aegis

{
  "error": false,
  "data": {
    "city": "São Paulo",
    "country": "BR",
    "coordinates": {
      "lon": -46.6333,
      "lat": -23.5505
    },
    "timezone": {
      "offsetSeconds": -10800,
      "offsetHours": -3,
      "utc": "UTC-03:00"
    },
    "observedAt": {
      "timestamp": 1718200800,
      "utc": "2024-06-12T14:00:00Z",
      "local": "2024-06-12T11:00:00"
    },
    "temperature": {
      "unit": "celsius",
      "current": 22.4,
      "currentFahrenheit": 72.3,
      "feelsLike": 23.1,
      "tempMin": 19.8,
      "tempMax": 24.6
    },
    "humidity": 72,
    "pressure": {
      "sea": 1013.2,
      "ground": 934.5
    },
    "visibility": {
      "meters": 10000,
      "kilometers": 10
    },
    "cloudiness": 40,
    "wind": {
      "speed": 3.6,
      "speedKmh": 12.96,
      "gust": 5.2,
      "deg": 220,
      "direction": "SW"
    },
    "precipitation": {
      "rainLastHour": 0.5,
      "snowLastHour": 0
    },
    "sun": {
      "sunrise": 1718175240,
      "sunset": 1718214360,
      "sunriseUtc": "2024-06-12T07:14:00Z",
      "sunsetUtc": "2024-06-12T18:06:00Z",
      "sunriseLocal": "2024-06-12T04:14:00",
      "sunsetLocal": "2024-06-12T15:06:00",
      "daylightSeconds": 39120,
      "isDaytime": true
    },
    "weather": {
      "id": 802,
      "main": "Clouds",
      "description": "scattered clouds",
      "icon": "partly-cloudy",
      "iconUrl": "https://api.aegi.run/v1/icons/weather/partly-cloudy.png"
    }
  },
  "requestId": "req_a3f7c2e1b84d9056ef123abc45678def"
}

Returns current temperature, wind, humidity, pressure, visibility, precipitation, sun schedule and a weather icon for the requested city. All text fields are returned in English.

Authentication

AuthorizationBearer

Create a key at https://aegi.run, then send it as Authorization: Bearer aegis.<key>.

Query parameters

citystringRequired

Name of the city to search for. A country code can be appended, e.g. "London,GB".

Response

Weather successfully retrieved

errorboolean

Indicates if an error occurred

dataobject or null

Payload data containing weather details

requestIdstring

Unique identifier for the request

Errors

400

Bad Request Error

404

Not Found Error

500

Internal Server Error