WindBorne API
WindBorne’s API serves the latest forecasts from its cutting-edge forecast models WeatherMesh & MetaMesh, and the latest observations + soundings from its global constellation of hundreds of long-duration weather balloons.
Getting Started
Authenticate, then call the API from Python, the command line, or an AI assistant.
Install, configure, and make your first call
API keys, headers, and security best practices
Connect an LLM or AI agent to query the API
Use the API from Python or the command line
Work with JSON, CSV, and gridded data
Connect the API to tools and platforms that support OpenAPI
Weather
Forecasts, recent observations, weather events, and climatology for the places you care about.
Point Forecasts & Context
Retrieve point-based forecast data
Point forecasts with optional observations and climate context
External Observations
Events
Events of one type forecast by a model run
Browse persistent event IDs across runs
One event's forecast for a selected model run
Available model runs containing an event
Events forecast to affect a point
Degree Days
Heating Degree Days by state
Cooling Degree Days by state
Tropical Cyclones
Forecasts for all active tropical cyclones
Browse the tropical cyclone catalog
Detailed forecast for one tropical cyclone
Available forecast cycles by cyclone
Climatology
Average weather by hour for a location
Daily climate statistics for a location
Custom Calculations
Evaluate a calculation over a geographic area
Evaluate a calculation at specific coordinates
Select areas that meet a calculation threshold
Check a calculation before running it
Models
Output from each forecast model run, by model and initialization time. Use it for analysis and gridded data.
Model Availability
Available model run start times
Archived model run start times
Available variables by model
Available forecast hours and generation times
Available calculation times for degree day and tropical cyclone forecasts
List of supported station IDs for point forecasts
Model Outputs
Interpolated point forecasts from gridded output
Vertical atmospheric profile forecast for a coordinate
Returns a sentence and icon describing weather conditions at a point
Download gridded forecast data
Atlas
Positions
Metadata for all flying GSBs
Active and historical GSBs with position data
Launch site metadata
Current location of the GSB
Flight path of the GSB
Predicted flight path of the GSB
Observations
Balloon measurements as observations, super observations, and soundings.
Get the atmospheric observations from all flying GSBs
Get the superobbed atmospheric observations from all flying GSBs
Discover available atmospheric soundings by time, location, and mission
Retrieve full vertical profile data for a specific sounding
Webhooks
Manage Webhooks
Configure a webhook and its subscriptions
All of your webhooks, one page at a time
One webhook with all of its subscriptions
Change a webhook's URL, name, note, or active state
Delete a webhook and all of its subscriptions
Manage Subscriptions
Add a subscription to an existing webhook
Change one subscription's settings
Remove one subscription from a webhook