Quickstart

Your first Convek API request.

Create a free API key, call /v1/site, and read soaring forecast fields as JSON.

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-05-25",
  "valid_time": "13:00",
  "rasp_model": "gb/4km",
  "site": {
    "wstar_ms": 2.4,
    "hglider_agl_m": 1520,
    "cloudbase_agl_ft": 5200,
    "day_rating": "good"
  }
}

1. Create a key

Sign up, open the dashboard, and create a live key for real forecast data or a sandbox key for repeatable test responses.

2. Choose a region

Live 4 km regions are UK, Germany, Switzerland, Austria, Slovenia, and Czechia. Use the regions endpoint to read the current list.

3. Pick the endpoint

The site endpoint is the fastest start. Move to forecast, grid, corridor, or sounding endpoints when the UI needs more structure.

4. Keep the disclaimer

Convek is model-derived forecast data. It is not official aviation weather and should not be the sole basis for flight decisions.

Create a Free API Key OpenAPI reference