Tomorrow.io

aid: tomorrow-io
url: https://raw.githubusercontent.com/api-evangelist/tomorrow-io/refs/heads/main/apis.yml
name: Tomorrow.io
description: Tomorrow.io is a Boston-based weather intelligence platform combining a global proprietary numerical weather
  model, a constellation of microsatellite weather radars, and a developer-facing v4 REST API. The platform exposes 60+ hyperlocal
  data layers — core weather, air quality, pollen, solar, soil, fire, flood, lightning, maritime, aviation, road — together
  with map tiles, severe-weather event detection, routable forecast queries, climate normals, historical archive access, customer-defined
  locations, named insights, and threshold-based webhook alerts. Used by airlines, on-demand logistics platforms, agriculture,
  energy, and the US Air Force, Tomorrow.io's API is designed for ETA-aware route planning, geofenced alerting, agentic workflows,
  and large-scale operational decisioning under weather risk.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://www.tomorrow.io/favicon-32x32.png
humanURL: https://www.tomorrow.io
baseURL: https://api.tomorrow.io/v4
tags:
- Weather
- Forecast
- Climate
- Risk
- Air Quality
- Pollen
- Lightning
- Severe Weather
- Maps
- Routing
- Satellite
- Microsatellites
- Radar
- Geospatial
- Alerts
kind: contract
access: 3rd-Party
created: '2026-05-24'
modified: '2026-05-24'
specificationVersion: '0.16'
type: Index
apis:
- aid: tomorrow-io:tomorrow-io-historical-api
  name: Tomorrow.io Historical Weather API
  tags:
  - Weather
  - Historical
  - Climate
  - Climate Normals
  humanURL: https://docs.tomorrow.io/reference/historical
  baseURL: https://api.tomorrow.io/v4
  properties:
  - url: https://docs.tomorrow.io/reference/historical
    type: Documentation
  - url: https://docs.tomorrow.io/reference/historical-weather-retrieval
    type: APIReference
  - url: https://docs.tomorrow.io/reference/climate-normals
    type: APIReference
  - url: openapi/tomorrow-io-historical-api-openapi.yml
    type: OpenAPI
  description: Retrieve historical weather observations and monthly climate normals for any point or polygon on Earth using
    the same field catalog as the realtime and forecast APIs.
- aid: tomorrow-io:tomorrow-io-events-api
  name: Tomorrow.io Events API
  tags:
  - Weather
  - Events
  - Severe Weather
  - Lightning
  - Floods
  - Fire
  humanURL: https://docs.tomorrow.io/reference/retrieve-events-basic
  baseURL: https://api.tomorrow.io/v4
  properties:
  - url: https://docs.tomorrow.io/reference/retrieve-events-basic
    type: APIReference
  - url: https://docs.tomorrow.io/reference/severe-weather-events
    type: Documentation
  - url: openapi/tomorrow-io-events-api-openapi.yml
    type: OpenAPI
  - url: json-schema/tomorrow-io-event-schema.json
    type: JSONSchema
  - url: examples/tomorrow-io-events-example.json
    type: Examples
  description: Retrieve severe weather events, fires, floods, lightning swarms, and custom vector events affecting a point
    or geometry.
- aid: tomorrow-io:tomorrow-io-route-api
  name: Tomorrow.io Weather on Routes API
  tags:
  - Weather
  - Route
  - Logistics
  - ETA
  humanURL: https://docs.tomorrow.io/reference/route
  baseURL: https://api.tomorrow.io/v4
  properties:
  - url: https://docs.tomorrow.io/reference/route
    type: APIReference
  - url: openapi/tomorrow-io-route-api-openapi.yml
    type: OpenAPI
  - url: examples/tomorrow-io-route-example.json
    type: Examples
  description: Retrieve weather along an arbitrary polyline of waypoints at the times each segment is expected to be traversed
    — powers route optimization, logistics planning, and ETA-aware hazard detection.
- aid: tomorrow-io:tomorrow-io-locations-api
  name: Tomorrow.io Locations API
  tags:
  - Weather
  - Locations
  - Geometry
  humanURL: https://docs.tomorrow.io/reference/list-locations
  baseURL: https://api.tomorrow.io/v4
  properties:
  - url: https://docs.tomorrow.io/reference/list-locations
    type: APIReference
  - url: openapi/tomorrow-io-locations-api-openapi.yml
    type: OpenAPI
  - url: json-schema/tomorrow-io-location-schema.json
    type: JSONSchema
  description: Manage saved locations (points, polygons, lines) referenced by ``locationId`` across the Tomorrow.io APIs,
    with tag-based cohorts for fleet, customer, or asset organization.
- aid: tomorrow-io:tomorrow-io-alerts-api
  name: Tomorrow.io Alerts API
  tags:
  - Weather
  - Alerts
  - Webhooks
  - Notifications
  humanURL: https://docs.tomorrow.io/reference/create-alerts
  baseURL: https://api.tomorrow.io/v4
  properties:
  - url: https://docs.tomorrow.io/reference/create-alerts
    type: APIReference
  - url: openapi/tomorrow-io-alerts-api-openapi.yml
    type: OpenAPI
  - url: json-schema/tomorrow-io-alert-schema.json
    type: JSONSchema
  - url: examples/tomorrow-io-alert-example.json
    type: Examples
  description: Create and manage threshold-based weather alerts that evaluate Tomorrow.io data layers against custom rules
    for linked locations and deliver notifications via webhook, email, and the Tomorrow.io app.
- aid: tomorrow-io:tomorrow-io-insights-api
  name: Tomorrow.io Insights API
  tags:
  - Weather
  - Insights
  - Rules
  humanURL: https://docs.tomorrow.io/reference/list-insights
  baseURL: https://api.tomorrow.io/v4
  properties:
  - url: https://docs.tomorrow.io/reference/list-insights
    type: APIReference
  - url: openapi/tomorrow-io-insights-api-openapi.yml
    type: OpenAPI
  - url: json-schema/tomorrow-io-insight-schema.json
    type: JSONSchema
  description: Define and manage reusable Insights — named rules combining Tomorrow.io data layers, operators, and thresholds
    — that power the Events and Alerts APIs.
- aid: tomorrow-io:tomorrow-io-forecast-api
  name: Tomorrow.io Forecast API
  description: 1h / 1d step weather forecast for the next 14 days.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Forecast
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-io-forecast-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: APIReference
    url: https://docs.tomorrow.io/reference/realtime-weather
  - type: APIReference
    url: https://docs.tomorrow.io/reference/weather-forecast
  - type: APIReference
    url: https://docs.tomorrow.io/reference/timelines-overview
  - type: JSONSchema
    url: json-schema/tomorrow-io-weather-values-schema.json
  - type: JSONStructure
    url: json-structure/tomorrow-io-weather-values-structure.json
  - type: Examples
    url: examples/tomorrow-io-realtime-example.json
  - type: Examples
    url: examples/tomorrow-io-timelines-example.json
  - type: Documentation
    url: https://docs.tomorrow.io/reference/map-overview
  - type: APIReference
    url: https://docs.tomorrow.io/reference/retrieve-a-tile-basic
- aid: tomorrow-io:tomorrow-io-maps-api
  name: Tomorrow.io Maps API
  description: Web Mercator tile service for weather layers.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Maps
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-io-maps-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: APIReference
    url: https://docs.tomorrow.io/reference/realtime-weather
  - type: APIReference
    url: https://docs.tomorrow.io/reference/weather-forecast
  - type: APIReference
    url: https://docs.tomorrow.io/reference/timelines-overview
  - type: JSONSchema
    url: json-schema/tomorrow-io-weather-values-schema.json
  - type: JSONStructure
    url: json-structure/tomorrow-io-weather-values-structure.json
  - type: Examples
    url: examples/tomorrow-io-realtime-example.json
  - type: Examples
    url: examples/tomorrow-io-timelines-example.json
  - type: Documentation
    url: https://docs.tomorrow.io/reference/map-overview
  - type: APIReference
    url: https://docs.tomorrow.io/reference/retrieve-a-tile-basic
- aid: tomorrow-io:tomorrow-io-realtime-api
  name: Tomorrow.io Realtime API
  description: Current weather conditions for a point or location.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Realtime
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-io-realtime-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: APIReference
    url: https://docs.tomorrow.io/reference/realtime-weather
  - type: APIReference
    url: https://docs.tomorrow.io/reference/weather-forecast
  - type: APIReference
    url: https://docs.tomorrow.io/reference/timelines-overview
  - type: JSONSchema
    url: json-schema/tomorrow-io-weather-values-schema.json
  - type: JSONStructure
    url: json-structure/tomorrow-io-weather-values-structure.json
  - type: Examples
    url: examples/tomorrow-io-realtime-example.json
  - type: Examples
    url: examples/tomorrow-io-timelines-example.json
  - type: Documentation
    url: https://docs.tomorrow.io/reference/map-overview
  - type: APIReference
    url: https://docs.tomorrow.io/reference/retrieve-a-tile-basic
- aid: tomorrow-io:tomorrow-io-timelines-api
  name: Tomorrow.io Timelines API
  description: Flexible timeline retrieval across any combination of fields and timesteps.
  humanURL: https://docs.tomorrow.io/reference/welcome
  baseURL: https://api.tomorrow.io/v4
  tags:
  - Timelines
  properties:
  - type: OpenAPI
    url: openapi/tomorrow-io-timelines-api-openapi.yml
  - type: Documentation
    url: https://docs.tomorrow.io/reference/welcome
  - type: APIReference
    url: https://docs.tomorrow.io/reference/realtime-weather
  - type: APIReference
    url: https://docs.tomorrow.io/reference/weather-forecast
  - type: APIReference
    url: https://docs.tomorrow.io/reference/timelines-overview
  - type: JSONSchema
    url: json-schema/tomorrow-io-weather-values-schema.json
  - type: JSONStructure
    url: json-structure/tomorrow-io-weather-values-structure.json
  - type: Examples
    url: examples/tomorrow-io-realtime-example.json
  - type: Examples
    url: examples/tomorrow-io-timelines-example.json
  - type: Documentation
    url: https://docs.tomorrow.io/reference/map-overview
  - type: APIReference
    url: https://docs.tomorrow.io/reference/retrieve-a-tile-basic
common:
- type: AgenticAccess
  url: agentic-access/tomorrow-io-agentic-access.yml
- type: DomainSecurity
  url: security/tomorrow-io-domain-security.yml
- type: Authentication
  url: authentication/tomorrow-io-authentication.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/tomorrowio/overview
- type: Arazzo
  url: arazzo/tomorrow-io-alert-threshold-tuning-workflow.yml
  name: Tomorrow.io Alert Threshold Tuning
- type: Arazzo
  url: arazzo/tomorrow-io-decommission-location-workflow.yml
  name: Tomorrow.io Decommission a Monitored Location
- type: Arazzo
  url: arazzo/tomorrow-io-historical-and-normals-analysis-workflow.yml
  name: Tomorrow.io Historical and Climate Normals Analysis
- type: Arazzo
  url: arazzo/tomorrow-io-insight-driven-alert-setup-workflow.yml
  name: Tomorrow.io Insight-Driven Alert Setup
- type: Arazzo
  url: arazzo/tomorrow-io-insight-scoped-event-query-workflow.yml
  name: Tomorrow.io Insight-Scoped Event Query
- type: Arazzo
  url: arazzo/tomorrow-io-location-severe-weather-events-workflow.yml
  name: Tomorrow.io Location Severe Weather Events
- type: Arazzo
  url: arazzo/tomorrow-io-map-tile-precipitation-overlay-workflow.yml
  name: Tomorrow.io Map Tile Precipitation Overlay
- type: Arazzo
  url: arazzo/tomorrow-io-realtime-then-timelines-deep-dive-workflow.yml
  name: Tomorrow.io Realtime Snapshot then Timelines Deep Dive
- type: Arazzo
  url: arazzo/tomorrow-io-realtime-vs-climate-normals-workflow.yml
  name: Tomorrow.io Realtime vs Climate Normals Benchmark
- type: Arazzo
  url: arazzo/tomorrow-io-route-weather-hazard-scan-workflow.yml
  name: Tomorrow.io Route Weather Hazard Scan
- type: Arazzo
  url: arazzo/tomorrow-io-saved-location-realtime-forecast-workflow.yml
  name: Tomorrow.io Saved Location Realtime and Forecast
- type: Arazzo
  url: arazzo/tomorrow-io-tag-location-cohort-workflow.yml
  name: Tomorrow.io Tag and Monitor a Location Cohort
- url: https://www.tomorrow.io
  type: Portal
- url: https://docs.tomorrow.io
  name: Tomorrow.io API Documentation
  type: Documentation
- url: https://docs.tomorrow.io/reference/welcome
  name: API Reference
  type: APIReference
- url: https://app.tomorrow.io/development/keys
  name: API Keys
  type: Authentication
- url: https://app.tomorrow.io/signup
  name: Sign Up
  type: Signup
- url: https://app.tomorrow.io/signin
  name: Console
  type: Console
- url: https://docs.tomorrow.io/recipes
  name: Recipes Sandbox
  type: Sandbox
- url: https://docs.tomorrow.io/reference/getting-started
  name: Getting Started
  type: GettingStarted
- url: https://docs.tomorrow.io/reference/rate-limiting
  name: Rate Limiting & Tokens
  type: RateLimits
- url: https://docs.tomorrow.io/reference/error-handling
  name: Error Handling
  type: ErrorCodes
- url: https://docs.tomorrow.io/reference/release-notes
  name: Release Notes
  type: ChangeLog
- url: https://docs.tomorrow.io/llms.txt
  name: LLMs.txt
  type: Documentation
- url: https://docs.tomorrow.io/reference/tomorrow-io-mcp
  name: Tomorrow.io MCP Server
  type: Documentation
- url: https://www.tomorrow.io/pricing/
  name: Pricing
  type: Pricing
- url: https://www.tomorrow.io/legal/tos/
  name: Terms of Service
  type: TermsOfService
- url: https://www.tomorrow.io/legal/privacy-policy/
  name: Privacy Policy
  type: PrivacyPolicy
- url: https://support.tomorrow.io
  name: Help Center
  type: Support
- url: https://www.tomorrow.io/blog/
  name: Blog
  type: Blog
- url: https://github.com/Tomorrow-IO-API
  name: Tomorrow.io API GitHub Organization
  type: GitHubOrganization
- url: https://github.com/Tomorrow-IO-API/tomorrow-postman
  name: Official Postman Collection
  type: SDKs
- url: https://github.com/Tomorrow-IO-API/tomorrow-samples
  name: Official Code Samples
  type: SDKs
- url: https://github.com/Tomorrow-IO-API/tomorrow-route-mapbox
  name: Weather Navigator Sample (Mapbox)
  type: SDKs
- url: https://github.com/Tomorrow-IO-API/tomorrow-timelines-widget
  name: Tomorrow.io Timelines Widget
  type: SDKs
- url: https://github.com/Tomorrow-IO-API/tomorrow-events-charts
  name: Insights Dashboard Sample
  type: SDKs
- url: https://github.com/Tomorrow-IO-API/tomorrow-api-proxy
  name: Google Cloud Function API Proxy Sample
  type: SDKs
- url: https://github.com/Tomorrow-IO-API/tomorrow-netlify
  name: Netlify Edge Sample
  type: SDKs
- url: https://github.com/Tomorrow-IO-API/tomorrow-map-spectrums
  name: Map Spectrums and Legends
  type: SDKs
- url: https://github.com/Tomorrow-IO-API/tomorrow-weather-codes
  name: Official Weather Icons
  type: SDKs
- url: https://github.com/Tomorrow-IO-API/climate-normals
  name: Climate Normals Visualization (Python)
  type: SDKs
- url: https://www.linkedin.com/company/tomorrow-io
  type: LinkedIn
- url: https://twitter.com/tomorrow_io
  type: Twitter
- url: rules/tomorrow-io-rules.yml
  type: SpectralRules
- url: vocabulary/tomorrow-io-vocabulary.yml
  type: Vocabulary
- url: json-ld/tomorrow-io-context.jsonld
  type: JSONLD
- url: plans/tomorrow-io-plans-pricing.yml
  type: Plans
- url: rate-limits/tomorrow-io-rate-limits.yml
  type: RateLimits
- url: finops/tomorrow-io-finops.yml
  type: FinOps
- name: Features
  type: Features
  data:
  - name: 60+ Hyperlocal Data Layers
    description: Core weather, air quality, pollen, solar, soil, fire, flood, lightning, maritime, aviation, and road layers
      retrievable at point, polygon, or polyline geometry.
  - name: Proprietary Microsatellite Weather Radar Constellation
    description: Tomorrow.io operates its own constellation of space-based weather radars to fill gaps in terrestrial radar
      coverage, especially over oceans and the developing world.
  - name: Minutely Forecast Resolution
    description: 60-minute minute-by-minute precipitation forecast in addition to hourly and daily timelines (Enterprise tier).
  - name: 14-Day Forecast Horizon
    description: Daily forecast out to 14 days on Enterprise plans, 5 days on Free.
  - name: Climate Normals
    description: Monthly long-term averages for benchmarking current conditions against typical patterns.
  - name: Severe Weather and Custom Events
    description: First-class API for severe weather phenomena plus customer-defined vector events for proprietary hazard models.
  - name: Threshold Alerts with Webhooks
    description: Define rule-based alerts that fire webhooks and emails when conditions cross thresholds for linked locations.
  - name: Weather Map Tiles
    description: Web Mercator PNG tiles for visualizing every data layer in Mapbox, MapLibre, Leaflet, OpenLayers, Google
      Maps.
  - name: Weather on Routes
    description: ETA-aware weather retrieval along a polyline of waypoints for logistics, aviation, and maritime planning.
  - name: MCP Server
    description: Official Tomorrow.io Model Context Protocol server for agentic AI access to the Weather API.
  - name: 99.9% Uptime SLA
    description: Enterprise SLA with rate-limit response headers exposed for programmatic monitoring.
  - name: LLMs.txt Indexed Documentation
    description: Tomorrow.io publishes an LLMs.txt index of every documentation page and endpoint for AI agents.
- name: UseCases
  type: UseCases
  data:
  - name: Route Optimization and Logistics
    description: ETA-aware weather along truck, drone, and last-mile routes to avoid storms, ice, and visibility hazards.
  - name: Aviation Planning
    description: Airline operations centers and dispatch use Tomorrow.io for icing, turbulence, low-level wind shear, and
      aerodrome forecasts.
  - name: Energy Forecasting
    description: Wind and solar generation forecasting, load forecasting under heat events, and outage management.
  - name: Agriculture
    description: Soil moisture, evapotranspiration, frost, and growing-degree-day analytics for farm operations.
  - name: Severe Weather Alerting
    description: Geofenced alerting for tropical storms, severe thunderstorms, hail, lightning, and flash floods.
  - name: Sports and Outdoor Events
    description: Game-day, race-day, and venue operations under lightning, heat, and precipitation risk.
  - name: Insurance and Climate Risk
    description: Historical and climate-normals data for parametric insurance pricing and physical climate risk modeling.
  - name: Data Science
    description: Bulk historical timelines for training operational decision models and backtesting weather-sensitive workflows.
  - name: Maritime Operations
    description: Wave height, swell direction, and sea-state forecasting for shipping, offshore energy, and fisheries.
  - name: On-Demand Platforms
    description: Surge demand modeling and worker-safety alerting for rideshare, delivery, and on-demand services.
- name: Integrations
  type: Integrations
  data:
  - name: Mapbox
    description: Drop Tomorrow.io map tiles directly into Mapbox GL JS basemaps; official tomorrow-route-mapbox sample.
  - name: MapLibre
    description: Open-source slippy-map client compatible with the Tomorrow.io Maps API.
  - name: Leaflet
    description: Compatible with the Tomorrow.io Maps XYZ tile service.
  - name: Google Cloud Functions
    description: Official tomorrow-api-proxy sample demonstrates key-safe proxy deployment on GCP.
  - name: Netlify Edge
    description: Official tomorrow-netlify sample for serverless edge proxying.
  - name: Postman
    description: Official Tomorrow.io Postman collection covering every v4 endpoint.
  - name: Model Context Protocol (MCP)
    description: Official Tomorrow.io MCP server for plugging Weather, Forecast, Timelines, and Events into AI agents.
  - name: Webhooks
    description: First-class webhook delivery for alert notifications.
  - name: Insights Dashboard
    description: tomorrow-events-charts open-source dashboard demonstrating the Events API.
- name: Solutions
  type: Solutions
  data:
  - name: Weather API for Developers
    description: Self-serve developer API with 60+ data layers, Postman collection, and MCP server.
  - name: Tomorrow.io Resilience Platform
    description: Operational dashboards, alerts, and decision automation built on top of the Tomorrow.io Weather API.
  - name: Aviation Resilience
    description: Vertical solution for airline operations centers, dispatch, and aerodrome operations.
  - name: Energy Resilience
    description: Vertical solution for utility load forecasting, generation forecasting, and outage management.
  - name: Logistics Resilience
    description: Vertical solution for fleet, freight, and last-mile delivery routing under weather risk.
  - name: Government and Defense
    description: Tomorrow.io serves the US Air Force and other defense and government customers with operational weather intelligence
      and proprietary space-based weather radar.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
  X-twitter: https://x.com/kinlane