# WindBorne API Docs Index # Getting started Set up credentials and make your first API request. # Technical Guides ## Authentication How to authenticate with your WB_API_KEY using Bearer token authentication. ## JWT Tokens Generate short-lived JWTs signed with WB_API_KEY and use them for auth. ## MCP Apps Connect compatible AI assistants to Weather by WindBorne for interactive WeatherMesh forecasts and maps. ## Model Context Protocol (MCP) Access WindBorne data via the Model Context Protocol (MCP). ## Python SDK & CLI Install and configure the windborne Python package and CLI. ## File Formats Supported response formats (JSON, NetCDF, Zarr, PrepBUFR) and utilities. ## Webhooks Learn how WindBorne webhook subscriptions, deliveries, signatures, and retries work. # Models Measurements ## Observation Data What WindBorne's Global Sounding Balloons measure, how data is delivered, and what to expect from the API. ## External Models External forecast models supported alongside WeatherMesh. ## WindBorne Models WindBorne's best in class AI-based weather forecast models. ## MetaMesh MetaMesh: Multi-model blended weather forecasts combining the best of multiple forecast systems. ## WeatherMesh-6 WeatherMesh-6: Next-generation global weather model with high-resolution regional forecasting. ## Time in Forecasts How initialization times, forecast zero, flavors, forecast hours, and valid times work in weather forecasting. # Observations ## Introduction to the Observations API Atmospheric observations and soundings from WindBorne's balloon constellation. ## Observations Retrieve weather observations from WindBorne's global sounding balloon constellation ## Sounding by ID Retrieve full atmospheric sounding data for a specific sounding ID. ## Soundings Discover which atmospheric soundings have been collected by WindBorne's global balloon constellation. ## Super Observations Retrieve superobbedweather observations from WindBorne's global sounding balloon constellation # Atlas ## Constellation Status List active and historical flying GSBs with status, metadata, and current position. ## Current Location Get the latest known location and state for a GSB. ## Flight Path Get recent transmitted flight path points for a GSB. ## Flying Missions List active and historical flying GSBs with status and metadata. ## Introduction to the Atlas API Mission metadata, positions, and flight paths for WindBorne's balloon constellation. ## Mission Launch Site Find the launch site information for a given GSB. ## Predicted Flight Path Get the predicted flight path for a GSB based on current conditions. # Forecasts ## About the Tropical Cyclone Tracker How the WeatherMesh-6 Tropical Cyclone Tracker detects, matches, and summarizes ensemble storm tracks. ## Archived Initialization Times List archived initialization times for forecast models. ## Available Stations List all weather stations with point forecasts ## Calculation Times List available calculation times for degree day and tropical cyclone forecasts. ## Climatology Get hourly ERA5 normals at any coordinate. ## Conditions Get ranked, human-readable conditions across a point forecast's full horizon. ## Forecasted Sounding Get interpolated vertical atmospheric profile forecasts for a specific coordinate. ## Gridded Forecast Download gridded forecast output as NetCDF. ## Index Tropical Cyclones Browse the tropical cyclone catalog. ## Initialization Times List available model initialization times for forecasts. ## Initialization Times for Tropical Cyclone List initialization times available for a tropical cyclone. ## Interpolated Point Forecast Interpolate gridded output to get forecasts at arbitrary coordinates. ## Point Forecast Get the forecasts for specific coordinates ## Recent ASOS Observations Retrieve recent surface observations for an ASOS station. ## Run Information Get information for a specific model run ## Tropical Cyclone Detail Detailed forecast for one tropical cyclone. ## Tropical Cyclones Forecasts for all active tropical cyclones. ## Variables List available variables and vertical levels for a given model. ## Weather Context Fetch forecasts, conditions, observations, and normals in one request. # Insights ## Population Weighted CDDs Population-weighted Cooling Degree Days (CDD) forecasts for US states. ## Population Weighted HDDs Population-weighted Heating Degree Days (HDD) forecasts for US states. # Webhooks ## Add Subscription Add a new subscription to an existing webhook. ## Create Webhook Register a new webhook endpoint with optional subscriptions. ## degree_days Attach heating and cooling degree day forecasts to a webhook delivery. ## degree_days.available Sent when heating and cooling degree day forecasts become available for a model run. ## Delete Subscription Remove a single subscription from a webhook. ## Delete Webhook Permanently delete a webhook and all its subscriptions. ## forecast_hour.available Sent as each individual forecast output becomes available. ## Get Webhook Retrieve full details of a single webhook, including all subscriptions. ## gridded Attach time-limited gridded-forecast URLs to a webhook delivery. ## initialization_time.available Sent once when dlviz has received every expected forecast hour for a model run. ## interpolated_point_forecast Attach an interpolated point-forecast response to a webhook delivery. ## List Webhooks Retrieve a paginated list of your webhooks. ## Ping Subscription Send a test delivery for a specific subscription. ## tropical_cyclones Attach time-limited tropical cyclone detail URLs to a webhook delivery. ## tropical_cyclones.available Sent when tropical cyclone forecasts are available for a model run. ## Update Subscription Partially update a single subscription. ## Update Webhook Update webhook properties such as URL, name, note, or active state.