For Developers

Build soaring weather into your app.

The Convek API is a REST JSON API - designed like a modern API should be. Key auth, rate limiting, OpenAPI docs, sandbox environment. The soaring data layer the ecosystem has been missing.

Everything a developer expects.

The API primitives you're used to - applied to soaring weather for the first time.

REST + JSON

Standard HTTP GET/POST endpoints returning structured JSON. Predictable field names, typed values, clear units.

API key auth

Self-serve key generation via the dashboard. Up to 5 keys per account. Keys are prefixed for easy identification in logs.

Rate limiting

Per-key, per-day rate limits with clear headers. Upgrade your plan when you need more.

Sandbox environment

Sandbox keys serve archived forecast data - perfect for testing without burning real quota. Free, unlimited.

OpenAPI schema

Full OpenAPI 3.1 schema for all endpoints. Generate typed clients, validate responses, integrate with your toolchain.

Corridor sampling

The only soaring weather API with route corridor sampling. POST a bearing + distance, get weather along the route. Time-aware mode included.

Up and running in minutes.

Get a free API key from the dashboard, then query any covered coordinate with region, resolution, lat, and lon. Use /v1/site for one hour, /v1/forecast for the whole day, and /v1/grid when you need map layers.

Request

curl "https://api.convek.dev/v1/site?region=gb&resolution=4km&lat=51.88&lon=-1.55&time=13:00" \
-H "Authorization: Bearer cvk_live_your_key_here"

Response

{
"valid_date": "2026-04-14",
"valid_time": "13:00",
"rasp_model": "gb/4km",
"site": {
"wstar_ms": 2.4,
"hglider_agl_m": 1520,
"cloudbase_agl_ft": 5200,
"thermal_trigger_temp_c": null,
"surface_wind_speed_ms": 3.4,
"day_rating": "good"
}
}

Available endpoints

GET/v1/siteSingle-point soaring forecast. 30+ fields.
GET/v1/forecastFull-day hourly point forecast for charts, time series, and planning.
GET/v1/gridBounded grid field slices for maps, embeds, and app overlays. Dev tiers.
POST/v1/corridorRoute corridor sampling with optional time-aware mode.
GET/v1/soundingFull vertical atmospheric profile.
GET/v1/regionsList available regions and their resolution/status.
GET/v1/healthAPI health check.

Developer plans.

Start on the free tier to prototype. Move to Dev (£39/mo) or Dev Pro (£99/mo) for commercial use, grid slices, and higher limits. Sandbox keys are always free and unlimited.

Grid is a bounded slice product, not a full-domain dump. Current slice caps are 12,000 cells on Dev and sandbox, 30,000 on Dev Pro, and 60,000 on Partner.