SupaWeatherSupaweather APIs
SupaWeather API

Schemas

CurrentWeatherResponse

  • locationobject · required
    Example: {"lat":40.7128,"lon":-74.006,"name":"New York","country":"United States","region":"New York","timezone":"America/New_York"}
  • currentobject · required
    Example: {"temperature":22.5,"feels_like":24.1,"humidity":65,"pressure":1013.2,"wind_speed":3.2,"wind_direction":220,"visibility":10,"uv_index":5.2,"condition":{"main":"Clouds","description":"Partly cloudy","icon":"02d"}}
  • timestampstring · date-time · required

ForecastResponse

  • locationobject · required
    Example: {"lat":40.7128,"lon":-74.006,"name":"New York","country":"United States","region":"New York","timezone":"America/New_York"}
  • forecastobject · required

HistoricalWeatherResponse

  • locationobject
    Example: {"lat":40.7128,"lon":-74.006,"name":"New York","country":"United States","region":"New York","timezone":"America/New_York"}
  • dataobject[]
  • periodobject

AlertsResponse

  • locationobject
    Example: {"lat":40.7128,"lon":-74.006,"name":"New York","country":"United States","region":"New York","timezone":"America/New_York"}
  • alertsobject[]
  • countinteger

RadarResponse

  • locationobject
    Example: {"lat":40.7128,"lon":-74.006,"name":"New York","country":"United States","region":"New York","timezone":"America/New_York"}
  • radarobject

GeocodingResponse

  • resultsobject[]
  • countinteger

Location

  • latnumber · float · required
  • lonnumber · float · required
  • namestring · required
  • countrystring
  • regionstring
  • timezonestring

CurrentWeather

  • temperaturenumber · float · required
  • humidityinteger · max: 100 · required
  • pressurenumber · float · required
  • wind_speednumber · float · required
  • conditionobject · required
  • feels_likenumber · float
  • wind_directioninteger · max: 360
  • visibilitynumber · float
  • uv_indexnumber · float

WeatherCondition

  • mainstring · required
  • descriptionstring · required
  • iconstring · required

DailyForecast

  • datestring · date
  • temperatureobject
  • conditionobject
  • precipitationobject
  • windobject

HourlyForecast

  • datetimestring · date-time
  • temperaturenumber · float
  • conditionobject
  • precipitationnumber · float
  • wind_speednumber · float

HistoricalWeatherData

  • datestring · date
  • temperatureobject
  • precipitationnumber · float
  • humidityinteger
  • pressurenumber · float

WeatherAlert

  • idstring · required
  • titlestring · required
  • severitystring · enum · required
    Enum values:
    minor
    moderate
    severe
    extreme
  • start_timestring · date-time · required
  • end_timestring · date-time · required
  • descriptionstring
  • urgencystring · enum
    Enum values:
    immediate
    expected
    future
    past
  • certaintystring · enum
    Enum values:
    observed
    likely
    possible
    unlikely
  • eventstring
  • areasstring[]

GeocodingResult

  • namestring
  • latnumber · float
  • lonnumber · float
  • countrystring
  • regionstring
  • local_namesobject

ReverseGeocodingResponse

  • addressobject
  • latnumber · float
  • lonnumber · float
  • display_namestring

WeatherStationsResponse

  • stationsobject[]
  • countinteger

WeatherStation

  • idstring
  • namestring
  • locationobject
    Example: {"lat":40.7128,"lon":-74.006,"name":"New York","country":"United States","region":"New York","timezone":"America/New_York"}
  • elevationnumber · float
  • distancenumber · float
  • statusstring · enum
    Enum values:
    active
    inactive
    maintenance
  • last_observationstring · date-time
  • station_typestring · enum
    Enum values:
    automatic
    manual
    hybrid

MarineForecastResponse

  • locationobject
    Example: {"lat":40.7128,"lon":-74.006,"name":"New York","country":"United States","region":"New York","timezone":"America/New_York"}
  • marine_forecastobject[]

MarineForecastDay

  • datestring · date
  • wave_heightobject
  • wave_periodnumber · float
  • wave_directioninteger · max: 360
  • sea_temperaturenumber · float
  • tideobject
  • windobject
  • visibilitynumber · float

ClimateSummaryResponse

  • locationobject
    Example: {"lat":40.7128,"lon":-74.006,"name":"New York","country":"United States","region":"New York","timezone":"America/New_York"}
  • periodstring
  • monthly_dataobject[]
  • annual_summaryobject

MonthlyClimateData

  • monthinteger · min: 1 · max: 12
  • month_namestring
  • temperatureobject
  • precipitationobject
  • humidityobject

AnnualClimateData

  • avg_annual_temperaturenumber · float
  • total_annual_precipitationnumber · float
  • warmest_monthstring
  • coldest_monthstring
  • wettest_monthstring
  • driest_monthstring

AlertSubscriptionRequest

  • locationsobject[] · required
  • alert_typesstring[] · required
    Enum values:
    thunderstorm
    tornado
    flood
    hurricane
    snow
    heat
    cold
    wind
  • notification_methodobject · required
  • severity_levelsstring[]
    Enum values:
    minor
    moderate
    severe
    extreme
  • activeboolean
    Default: true

AlertSubscriptionResponse

  • subscription_idstring
  • statusstring · enum
    Enum values:
    active
    pending
    inactive
  • created_atstring · date-time
  • locationsobject[]
  • alert_typesstring[]
  • notification_methodobject

SatelliteImageryResponse

  • locationobject
    Example: {"lat":40.7128,"lon":-74.006,"name":"New York","country":"United States","region":"New York","timezone":"America/New_York"}
  • satelliteobject

Error

  • errorstring · required
  • messagestring · required
  • detailsobject
  • timestampstring · date-time
  • request_idstring