Tomorrow.io · Schema

ForecastResponse

ForecastResponse schema from Tomorrow.io Weather API

WeatherClimateForecastHistorical WeatherAir QualityPollenFireFloodRoutesMap TilesAviationMaritimePublic APIs

Properties

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

JSON Schema

forecast-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/forecast-response-schema.json",
  "title": "ForecastResponse",
  "description": "ForecastResponse schema from Tomorrow.io Weather API",
  "type": "object",
  "properties": {
    "timelines": {
      "type": "object",
      "properties": {
        "hourly": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "A single timestep entry in a timeline.",
            "properties": {
              "startTime": {
                "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
                  }
                }
              }
            }
          }
        },
        "daily": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "A single timestep entry in a timeline.",
            "properties": {
              "startTime": {
                "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"
        },
        "lon": {
          "type": "number",
          "format": "double"
        },
        "name": {
          "type": "string"
        }
      }
    }
  }
}