Skip to main content
Every openweathermap.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.
New to Corsair? See API access, authentication, and error handling.

​
History

​
timeMachine

history.timeMachine Get historical weather data for a specific timestamp (available from 1979-01-01) Risk: read 
await corsair.openweathermap.api.history.timeMachine({});
Input
NameTypeRequiredDescription
latnumberYesLatitude of the location
lonnumberYesLongitude of the location
dtnumberYesUnix timestamp (UTC) for the requested historical date
unitsstandard | metric | imperialNo—
langstringNo—
Output
NameTypeRequiredDescription
latnumberYes—
lonnumberYes—
timezonestringYes—
timezone_offsetnumberYes—
dataobject[]Yes—
{
  dt: number,
  sunrise: number,
  sunset: number,
  temp: number,
  feels_like: number,
  pressure: number,
  humidity: number,
  dew_point: number,
  uvi?: number,
  clouds: number,
  visibility?: number,
  wind_speed: number,
  wind_deg: number,
  wind_gust?: number,
  weather: {
    id: number,
    main: string,
    description: string,
    icon: string
  }[],
  rain?: {
    1h: number
  },
  snow?: {
    1h: number
  }
}[]

​
Summary

​
daySummary

summary.daySummary Get aggregated weather summary for a specific date (temperature, wind, precipitation) Risk: read 
await corsair.openweathermap.api.summary.daySummary({});
Input
NameTypeRequiredDescription
latnumberYesLatitude of the location
lonnumberYesLongitude of the location
datestringYesDate in YYYY-MM-DD format
unitsstandard | metric | imperialNo—
langstringNo—
tzstringNo—
Output
NameTypeRequiredDescription
latnumberYes—
lonnumberYes—
tzstringYes—
datestringYes—
unitsstringYes—
cloud_coverobjectYes—
humidityobjectYes—
precipitationobjectYes—
temperatureobjectYes—
pressureobjectYes—
windobjectYes—
{
  afternoon: number
}

{
  afternoon: number
}

{
  total: number
}

{
  min: number,
  max: number,
  afternoon: number,
  night: number,
  evening: number,
  morning: number
}

{
  afternoon: number
}

{
  max: {
    speed: number,
    direction: number
  }
}

​
overview

summary.overview Get a human-readable weather overview text for a location and date Risk: read 
await corsair.openweathermap.api.summary.overview({});
Input
NameTypeRequiredDescription
latnumberYesLatitude of the location
lonnumberYesLongitude of the location
datestringNo—
unitsstandard | metric | imperialNo—
Output
NameTypeRequiredDescription
latnumberYes—
lonnumberYes—
tzstringYes—
datestringYes—
unitsstringYes—
weather_overviewstringYes—

​
Weather

​
oneCall

weather.oneCall Get current weather, minutely/hourly/daily forecasts, and weather alerts for a location Risk: read 
await corsair.openweathermap.api.weather.oneCall({});
Input
NameTypeRequiredDescription
latnumberYesLatitude of the location
lonnumberYesLongitude of the location
excludecurrent | minutely | hourly | daily | alerts[]No—
unitsstandard | metric | imperialNo—
langstringNo—
Output
NameTypeRequiredDescription
latnumberYes—
lonnumberYes—
timezonestringYes—
timezone_offsetnumberYes—
currentobjectNo—
minutelyobject[]No—
hourlyobject[]No—
dailyobject[]No—
alertsobject[]No—
{
  dt: number,
  sunrise?: number,
  sunset?: number,
  temp: number,
  feels_like: number,
  pressure: number,
  humidity: number,
  dew_point: number,
  uvi: number,
  clouds: number,
  visibility?: number,
  wind_speed: number,
  wind_deg: number,
  wind_gust?: number,
  weather: {
    id: number,
    main: string,
    description: string,
    icon: string
  }[],
  rain?: {
    1h: number
  },
  snow?: {
    1h: number
  }
}

{
  dt: number,
  precipitation: number
}[]

{
  dt: number,
  temp: number,
  feels_like: number,
  pressure: number,
  humidity: number,
  dew_point: number,
  uvi: number,
  clouds: number,
  visibility?: number,
  wind_speed: number,
  wind_deg: number,
  wind_gust?: number,
  weather: {
    id: number,
    main: string,
    description: string,
    icon: string
  }[],
  pop: number,
  rain?: {
    1h: number
  },
  snow?: {
    1h: number
  }
}[]

{
  dt: number,
  sunrise: number,
  sunset: number,
  moonrise: number,
  moonset: number,
  moon_phase: number,
  summary?: string,
  temp: {
    day: number,
    min: number,
    max: number,
    night: number,
    eve: number,
    morn: number
  },
  feels_like: {
    day: number,
    night: number,
    eve: number,
    morn: number
  },
  pressure: number,
  humidity: number,
  dew_point: number,
  wind_speed: number,
  wind_deg: number,
  wind_gust?: number,
  weather: {
    id: number,
    main: string,
    description: string,
    icon: string
  }[],
  clouds: number,
  pop: number,
  rain?: number,
  snow?: number,
  uvi: number
}[]

{
  sender_name: string,
  event: string,
  start: number,
  end: number,
  description: string,
  tags: string[]
}[]