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 or /v1/forecast for the whole day.

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": 16.8,
"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.
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. Sandbox keys are always free and unlimited.