Tomorrow.io · JSON Structure
Forecast Response Structure
ForecastResponse schema from Tomorrow.io Weather API
Type: object
Properties: 2
WeatherClimateForecastHistorical WeatherAir QualityPollenFireFloodRoutesMap TilesAviationMaritimePublic APIs
ForecastResponse is a JSON Structure definition published by Tomorrow.io, describing 2 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Properties
timelines
location
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/tomorrow/refs/heads/main/json-structure/forecast-response-structure.json",
"name": "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": "datetime",
"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": "double",
"description": "Air temperature (Celsius for metric, Fahrenheit for imperial).",
"example": 21.2
},
"temperatureApparent": {
"type": "double",
"example": 20.4
},
"humidity": {
"type": "double",
"example": 64.0
},
"dewPoint": {
"type": "double",
"example": 13.4
},
"windSpeed": {
"type": "double",
"example": 3.1
},
"windDirection": {
"type": "double",
"example": 220
},
"windGust": {
"type": "double",
"example": 6.2
},
"pressureSeaLevel": {
"type": "double",
"example": 1013.2
},
"pressureSurfaceLevel": {
"type": "double",
"example": 1010.5
},
"precipitationIntensity": {
"type": "double",
"example": 0.0
},
"precipitationProbability": {
"type": "double",
"example": 5
},
"precipitationType": {
"type": "int32",
"example": 0
},
"cloudCover": {
"type": "double",
"example": 12
},
"cloudBase": {
"type": "double",
"example": 1.5
},
"cloudCeiling": {
"type": "double",
"example": 2.4
},
"visibility": {
"type": "double",
"example": 16
},
"weatherCode": {
"type": "int32",
"example": 1000
},
"uvIndex": {
"type": "int32",
"example": 6
},
"uvHealthConcern": {
"type": "int32",
"example": 2
},
"epaIndex": {
"type": "int32",
"example": 42
},
"epaHealthConcern": {
"type": "int32",
"example": 1
},
"epaPrimaryPollutant": {
"type": "int32",
"example": 0
},
"particulateMatter25": {
"type": "double",
"example": 8.4
},
"particulateMatter10": {
"type": "double",
"example": 14.1
},
"pollutantO3": {
"type": "double",
"example": 28
},
"pollutantNO2": {
"type": "double",
"example": 11
},
"pollutantCO": {
"type": "double",
"example": 0.4
},
"pollutantSO2": {
"type": "double",
"example": 1
},
"treeIndex": {
"type": "int32",
"example": 2
},
"grassIndex": {
"type": "int32",
"example": 1
},
"weedIndex": {
"type": "int32",
"example": 1
},
"fireIndex": {
"type": "double",
"example": 8.2
},
"solarGHI": {
"type": "double",
"example": 480
},
"solarDIF": {
"type": "double",
"example": 120
},
"solarDIR": {
"type": "double",
"example": 360
},
"moonPhase": {
"type": "int32",
"example": 3
},
"hailBinary": {
"type": "int32",
"example": 0
}
}
}
}
}
},
"daily": {
"type": "array",
"items": {
"type": "object",
"description": "A single timestep entry in a timeline.",
"properties": {
"startTime": {
"type": "datetime",
"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": "double",
"description": "Air temperature (Celsius for metric, Fahrenheit for imperial).",
"example": 21.2
},
"temperatureApparent": {
"type": "double",
"example": 20.4
},
"humidity": {
"type": "double",
"example": 64.0
},
"dewPoint": {
"type": "double",
"example": 13.4
},
"windSpeed": {
"type": "double",
"example": 3.1
},
"windDirection": {
"type": "double",
"example": 220
},
"windGust": {
"type": "double",
"example": 6.2
},
"pressureSeaLevel": {
"type": "double",
"example": 1013.2
},
"pressureSurfaceLevel": {
"type": "double",
"example": 1010.5
},
"precipitationIntensity": {
"type": "double",
"example": 0.0
},
"precipitationProbability": {
"type": "double",
"example": 5
},
"precipitationType": {
"type": "int32",
"example": 0
},
"cloudCover": {
"type": "double",
"example": 12
},
"cloudBase": {
"type": "double",
"example": 1.5
},
"cloudCeiling": {
"type": "double",
"example": 2.4
},
"visibility": {
"type": "double",
"example": 16
},
"weatherCode": {
"type": "int32",
"example": 1000
},
"uvIndex": {
"type": "int32",
"example": 6
},
"uvHealthConcern": {
"type": "int32",
"example": 2
},
"epaIndex": {
"type": "int32",
"example": 42
},
"epaHealthConcern": {
"type": "int32",
"example": 1
},
"epaPrimaryPollutant": {
"type": "int32",
"example": 0
},
"particulateMatter25": {
"type": "double",
"example": 8.4
},
"particulateMatter10": {
"type": "double",
"example": 14.1
},
"pollutantO3": {
"type": "double",
"example": 28
},
"pollutantNO2": {
"type": "double",
"example": 11
},
"pollutantCO": {
"type": "double",
"example": 0.4
},
"pollutantSO2": {
"type": "double",
"example": 1
},
"treeIndex": {
"type": "int32",
"example": 2
},
"grassIndex": {
"type": "int32",
"example": 1
},
"weedIndex": {
"type": "int32",
"example": 1
},
"fireIndex": {
"type": "double",
"example": 8.2
},
"solarGHI": {
"type": "double",
"example": 480
},
"solarDIF": {
"type": "double",
"example": 120
},
"solarDIR": {
"type": "double",
"example": 360
},
"moonPhase": {
"type": "int32",
"example": 3
},
"hailBinary": {
"type": "int32",
"example": 0
}
}
}
}
}
}
}
},
"location": {
"type": "object",
"properties": {
"lat": {
"type": "double"
},
"lon": {
"type": "double"
},
"name": {
"type": "string"
}
}
}
}
}