Cloudbase API

Cloudbase API for soaring forecasts.

Convek exposes cloudbase and boundary-layer fields directly, so flying tools do not need to infer cloudbase from generic humidity and temperature levels. It is designed for gliding, paragliding, hang gliding, and XC planning software.

What Convek gives you

  • Cloudbase above ground where convective cloud is forecast.
  • Boundary layer height and usable soaring height.
  • Sounding profiles for deeper checks at any covered coordinate.
  • Route and corridor samples that include height and cloudbase fields along a track.

What it does not give you

  • An official cloud ceiling product for aviation dispatch.
  • Real-time cloud observations or satellite nowcasting.
  • A yes/no safety decision for marginal hill or wave days.

Example API call

Cloudbase fields using a normal bearer API key.

Request

curl "https://api.convek.dev/v1/site?region=ch&resolution=4km&lat=46.62&lon=8.03&time=12:00" \
-H "Authorization: Bearer cvk_live_your_key_here"

Response

{
"valid_date": "2026-05-25",
"valid_time": "12:00",
"rasp_model": "ch/4km",
"site": {
"cloudbase_agl_ft": 6100,
"boundary_layer_m": 1960,
"hglider_agl_m": 1710,
"wstar_ms": 1.8
}
}

Endpoints this maps to

GET /v1/site

Cloudbase and boundary-layer values for a coordinate.

GET /v1/sounding

Vertical profile for checking stability and moisture.

GET /v1/forecast

Hourly cloudbase changes through the day.

POST /v1/corridor

Cloudbase and height data along an XC route.

When to pair it with other data

Official aviation weather

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

Open-Meteo

Use for broader weather variables and generic cloud layers.

openAIP

Use to combine cloudbase with nearby sites, airspace, and terrain context.

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 Convek when your app needs cloudbase and usable height as data, not as colours on a map.