Tomorrow.io · Schema

RealtimeWeatherResponse

RealtimeWeatherResponse schema from Tomorrow.io Weather API

WeatherClimateForecastHistorical WeatherAir QualityPollenFireFloodRoutesMap TilesAviationMaritimePublic APIs

Properties

Name Type Description
data object
location object
View JSON Schema on GitHub

JSON Schema

realtime-weather-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/tomorrow/refs/heads/main/json-schema/realtime-weather-response-schema.json",
  "title": "RealtimeWeatherResponse",
  "description": "RealtimeWeatherResponse schema from Tomorrow.io Weather API",
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "time": {
          "type": "string",
          "format": "date-time",
          "example": "2026-05-30T13:00:00Z"
        },
        "values": {
          "type": "object",
          "description": "Map of weather data field names to numeric values for one timestep.",
          "additionalProperties": true,
          "properties": {
            "temperature": {
              "type": "number",
              "format": "double",
              "description": "Air temperature (Celsius for metric, Fahrenheit for imperial).",
              "example": 21.2
            },
            "temperatureApparent": {
              "type": "number",
              "format": "double",
              "example": 20.4
            },
            "humidity": {
              "type": "number",
              "format": "double",
              "example": 64.0
            },
            "dewPoint": {
              "type": "number",
              "format": "double",
              "example": 13.4
            },
            "windSpeed": {
              "type": "number",
              "format": "double",
              "example": 3.1
            },
            "windDirection": {
              "type": "number",
              "format": "double",
              "example": 220
            },
            "windGust": {
              "type": "number",
              "format": "double",
              "example": 6.2
            },
            "pressureSeaLevel": {
              "type": "number",
              "format": "double",
              "example": 1013.2
            },
            "pressureSurfaceLevel": {
              "type": "number",
              "format": "double",
              "example": 1010.5
            },
            "precipitationIntensity": {
              "type": "number",
              "format": "double",
              "example": 0.0
            },
            "precipitationProbability": {
              "type": "number",
              "format": "double",
              "example": 5
            },
            "precipitationType": {
              "type": "integer",
              "example": 0
            },
            "cloudCover": {
              "type": "number",
              "format": "double",
              "example": 12
            },
            "cloudBase": {
              "type": "number",
              "format": "double",
              "example": 1.5
            },
            "cloudCeiling": {
              "type": "number",
              "format": "double",
              "example": 2.4
            },
            "visibility": {
              "type": "number",
              "format": "double",
              "example": 16
            },
            "weatherCode": {
              "type": "integer",
              "example": 1000
            },
            "uvIndex": {
              "type": "integer",
              "example": 6
            },
            "uvHealthConcern": {
              "type": "integer",
              "example": 2
            },
            "epaIndex": {
              "type": "integer",
              "example": 42
            },
            "epaHealthConcern": {
              "type": "integer",
              "example": 1
            },
            "epaPrimaryPollutant": {
              "type": "integer",
              "example": 0
            },
            "particulateMatter25": {
              "type": "number",
              "format": "double",
              "example": 8.4
            },
            "particulateMatter10": {
              "type": "number",
              "format": "double",
              "example": 14.1
            },
            "pollutantO3": {
              "type": "number",
              "format": "double",
              "example": 28
            },
            "pollutantNO2": {
              "type": "number",
              "format": "double",
              "example": 11
            },
            "pollutantCO": {
              "type": "number",
              "format": "double",
              "example": 0.4
            },
            "pollutantSO2": {
              "type": "number",
              "format": "double",
              "example": 1
            },
            "treeIndex": {
              "type": "integer",
              "example": 2
            },
            "grassIndex": {
              "type": "integer",
              "example": 1
            },
            "weedIndex": {
              "type": "integer",
              "example": 1
            },
            "fireIndex": {
              "type": "number",
              "format": "double",
              "example": 8.2
            },
            "solarGHI": {
              "type": "number",
              "format": "double",
              "example": 480
            },
            "solarDIF": {
              "type": "number",
              "format": "double",
              "example": 120
            },
            "solarDIR": {
              "type": "number",
              "format": "double",
              "example": 360
            },
            "moonPhase": {
              "type": "integer",
              "example": 3
            },
            "hailBinary": {
              "type": "integer",
              "example": 0
            }
          }
        }
      }
    },
    "location": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "number",
          "format": "double",
          "example": 42.3478
        },
        "lon": {
          "type": "number",
          "format": "double",
          "example": -71.0466
        },
        "name": {
          "type": "string",
          "example": "Cambridge, MA"
        },
        "type": {
          "type": "string",
          "example": "place"
        }
      }
    }
  }
}