Soaring Spot

Competition data scraped from Soaring Spot.

GET /api/soaringspot/countries

Returns a list of available countries with competitions.

Response

[
  { "name": "BE" },
  { "name": "FR" }
]

---

GET /api/soaringspot/competitions

Returns competitions grouped by category (in progress, upcoming, etc.).

Query Parameters

Parameter	Type	Description
country	string	Filter by country code
year	string	Filter by year
page	string	Page number for results

When no parameters are given, returns the Soaring Spot homepage competitions.

Response

[
  {
    "name": "Competitions in progress",
    "next_page": 2,
    "competitions": [
      {
        "id": "competition-slug-2024",
        "name": "Competition Name",
        "location": "City",
        "country": "BE",
        "start_date": "2024-07-01",
        "end_date": "2024-07-10"
      }
    ]
  }
]

---

GET /api/soaringspot/competitions/:id

Returns details for a single competition including classes and days.

Parameters

Parameter	Type	Description
id	string	Competition slug

Response

{
  "id": "competition-slug-2024",
  "name": "Competition Name",
  "location": "City",
  "country": "BE",
  "start_date": "2024-07-01",
  "end_date": "2024-07-10",
  "classes": [
    {
      "name": "Standard",
      "days": [
        {
          "id": "standard/task-1-on-2024-07-01",
          "name": "Task 1",
          "status": "valid",
          "date": "2024-07-01"
        }
      ]
    }
  ]
}

Day Status	Description
valid	Completed task
cancelled	Cancelled day
notask	No task set
practice	Practice day

---

GET /api/soaringspot/competitions/:id/pilots

Returns the competition’s pilot list, in the order of the page. A field a pilot’s row leaves blank is left out; club is also absent when the competition lists no clubs at all. An empty array means the competition has no pilot list yet.

Parameters

Parameter	Type	Description
id	string	Competition slug

Response

[
  {
    "competition_number": "SB",
    "name": "Shmuel Bruckstein",
    "club": "Megido",
    "glider": "ASW 24 B",
    "class_name": "Standard",
    "handicap": "108"
  }
]

---

GET /api/soaringspot/competitions/:id/flights/:class_id/:day_id

Returns daily flight results for a competition class and day.

Parameters

Parameter	Type	Description
id	string	Competition slug
class_id	string	Class identifier
day_id	string	Day identifier

Response

[
  {
    "rank": "1.",
    "competition_id": "AB",
    "link": "https://soaringspot.com/en_gb/download-contest-flight/...",
    "name": "Pilot Name",
    "country": "BE",
    "glider": "ASG 29",
    "start_time": "14:30:00",
    "end_time": "17:45:00",
    "speed": "120.50 km/h",
    "distance": "350.00 km",
    "points": "1,000",
    "warning": null
  }
]

Fields may be null for DNF (Did Not Finish) entries.

---

GET /api/soaringspot/competitions/:id/task/:class_id/:day_id

Returns the task details including waypoints and observation zones.

Parameters

Parameter	Type	Description
id	string	Competition slug
class_id	string	Class identifier
day_id	string	Day identifier

Response

{
  "name": "Task 1, Standard, 1 July 2024",
  "is_aat": false,
  "aat_minimum_duration": null,
  "distance": "350.00 km",
  "version": "v1",
  "notes": null,
  "inactive_airspace": null,
  "waypoints": [
    {
      "index": 0,
      "name": "Start",
      "latitude": 50.986,
      "longitude": 5.478,
      "type": "next",
      "is_line": true,
      "r1": 5000,
      "r2": 0,
      "a1": 180,
      "a2": 0,
      "a12": 0,
      "maximum_altitude": null
    }
  ]
}

Waypoint Type	Description
next	Next waypoint
previous	Previous waypoint
symmetric	Symmetric observation zone
fixed	Fixed angle sector