Convek
Route forecast API

Route forecast API for XC tasks and corridors.

A point forecast answers 'what is it like here?'. A task needs 'what changes down-route?'. Convek samples the soaring forecast along a whole route - named turnpoints, each leg, or one straight corridor - and can match every sample to the hour the pilot is predicted to reach it.

Create a Free API KeyQuickstart

What Convek gives you

  • Forecast samples at every waypoint or interpolated along each leg, with cumulative route distance and leg metadata.
  • Time-aware mode: give a launch time and ground speed, and each sample uses the forecast valid when the pilot arrives - rolling into the next hour, or the next day, down-track.
  • The same soaring fields as the point API at each sample: `wstar_ms`, cloudbase, usable height, wind levels, convergence, terrain height, and day rating.
  • A conservative route summary - weakest lift, lowest cloudbase, lowest day rating - across UK, Germany, Switzerland, Austria, Slovenia, and Czechia at 4 km.

What it does not give you

  • A 'safe to fly', go/no-go, or task-feasibility decision. The summary is descriptive, not prescriptive.
  • Airspace, turnpoint validation, NOTAMs, task scoring, or live traffic.
  • Official aviation weather, or a substitute for the pilot's own judgement in the air.

Example API call

Route briefing using a normal bearer API key.

Request

curl -X POST "https://api.convek.dev/v1/workflows/route-briefing" \
  -H "Authorization: Bearer cvk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "region": "gb",
    "resolution": "4km",
    "time_aware": true,
    "launch_time": "11:00",
    "ground_speed_kmh": 40,
    "sample_mode": "legs",
    "sample_spacing_km": 10,
    "points": [
      { "name": "Long Mynd", "lat": 52.53, "lon": -2.88 },
      { "name": "Wenlock Edge", "lat": 52.56, "lon": -2.62 },
      { "name": "Titterstone Clee", "lat": 52.40, "lon": -2.60 }
    ]
  }'

Response

{
  "valid_date": "2026-05-25",
  "rasp_model": "gb/4km",
  "route": {
    "distance_km": 34.1,
    "sample_mode": "legs",
    "time_aware": true
  },
  "samples": [
    {
      "kind": "waypoint",
      "waypoint_name": "Long Mynd",
      "along_route_km": 0,
      "estimated_arrival": "11:00",
      "wstar_ms": 1.8,
      "cloudbase_agl_ft": 4700,
      "day_rating": "good"
    }
  ],
  "summary": {
    "lowest_cloudbase_agl_ft": 4100,
    "weakest_wstar_ms": 1.1,
    "lowest_day_rating": "fair"
  }
}

Endpoints this maps to

POST /v1/workflows/route-briefing

Soaring weather along a multi-point route or task, by leg or by waypoint.

POST /v1/corridor

Weather along one straight line from a launch point, bearing, and distance.

GET /v1/site

A single point forecast for one leg or turnpoint on its own.

GET /v1/forecast

The full-day hourly curve at one point on the route.

When to pair it with other data

openAIP

Use openAIP for airspace, turnpoints, and flying-site data around the route.

OGN

Use Open Glider Network for live position and traffic along the task.

Official aviation weather

Use for METAR, TAF, warnings, and regulated flight planning.

Current coverage

Live 4 km regions are UK, Germany, Switzerland, Austria, Slovenia, and Czechia.

Route-first data

Corridor sampling turns a route into hourly forecast conditions along the line.

Built for integration

REST JSON, API keys, OpenAPI docs, sandbox keys, and stable endpoint names.

Use it in a real product.

Use this page as the API answer for route forecast, XC task planning, and corridor sampling searches. Route briefing for named multi-point tasks; corridor for one straight line.

See examplesCheck coverage