GET /api/v1/events/{eventId}/resultsscope: results:read

Event results

API v1 Last updated 2026-09-30 View as Markdown

#Event results

An event's series (multi-race) results — the four lists a club's public "results" tab shows: the main scoring results, overall standings, rating-group standings, and special-category standings.

#Headers

Header	Required	Value
`Authorization`	yes	`Bearer <access_token>`

#Path parameters

Param	Type	Note
`eventId`	UUID	`404 EVENT_NOT_FOUND` if unknown / another club's / not published

#Request

cURL

curl -s https://sail-club-server.cloud.run/api/v1/events/1143117a-9c2b-4e7a-8f1d-2b6a9c4e7f10/results \
  -H "Authorization: Bearer $TOKEN"

JavaScript/TypeScript (fetch)

const res = await fetch(`https://sail-club-server.cloud.run/api/v1/events/${eventId}/results`, {
  headers: { Authorization: `Bearer ${token}` },
});
const results = await res.json();

Python (requests)

res = requests.get(
    f"https://sail-club-server.cloud.run/api/v1/events/{event_id}/results",
    headers={"Authorization": f"Bearer {token}"},
    timeout=10,
)
results = res.json()

C# (HttpClient)

var res = await client.GetAsync($"/api/v1/events/{eventId}/results");
res.EnsureSuccessStatusCode();
var results = await res.Content.ReadFromJsonAsync<PublicApiEventResultsDto>();

PHP

<?php
$ch = curl_init("https://sail-club-server.cloud.run/api/v1/events/$eventId/results");
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer $token"]]);
$results = json_decode(curl_exec($ch), true);

#Response

{
  "results": [
    {
      "id": "4c5d8e3f-2a1b-40c9-8d8e-7f6c5d4e3f2a",
      "eventId": "1143117a-9c2b-4e7a-8f1d-2b6a9c4e7f10",
      "divisionId": "d1c0e9f8-a7b6-4c5d-8e3f-2a1b0c9d8e7f",
      "divisionName": "ORC A",
      "overallGroupId": "b6a9c4e7-f10a-41c0-8d2b-7e4a6f8c1d2e",
      "overallGroupName": "ORC",
      "rank": 1,
      "sailNumber": "TUR 501",
      "boatName": "Poyraz",
      "skipper": "A. Demir",
      "owner": "A. Demir",
      "modelClass": "First 40.7",
      "score": 4,
      "points": [
        { "raceNo": 1, "score": 1, "isDiscarded": false },
        { "raceNo": 2, "score": 3, "isDiscarded": false }
      ]
    }
  ],
  "overall": [
    { "id": "4c5d8e3f-2a1b-40c9-8d8e-7f6c5d4e3f2a", "overallGroupId": "b6a9c4e7-f10a-41c0-8d2b-7e4a6f8c1d2e",
      "overallGroupName": "ORC", "rank": 1, "sailNumber": "TUR 501", "boatName": "Poyraz",
      "skipper": "A. Demir", "score": 4,
      "points": [ { "raceNo": 1, "score": 1, "isDiscarded": false }, { "raceNo": 2, "score": 3, "isDiscarded": false } ] }
  ],
  "ratingGroups": [
    { "id": "4c5d8e3f-2a1b-40c9-8d8e-7f6c5d4e3f2a", "ratingGroup": "IRC 1", "rank": 1, "sailNumber": "TUR 501",
      "boatName": "Poyraz", "owner": "A. Demir", "score": 4,
      "points": [ { "raceNo": 1, "score": 1, "isDiscarded": false }, { "raceNo": 2, "score": 3, "isDiscarded": false } ] }
  ],
  "specialCategories": [
    { "id": "9d8e7f6c-5d4e-43f2-8a1b-0c9d8e7f6c5d", "specialCategoryId": "8e7f6c5d-4e3f-42a1-8b0c-9d8e7f6c5d4e",
      "categoryName": "Best Corinthian", "rank": 1, "sailNumber": "TUR 501", "boatName": "Poyraz",
      "skipper": "A. Demir", "totalScore": 4,
      "points": [ { "raceNo": 1, "score": 1, "isDiscarded": false }, { "raceNo": 2, "score": 3, "isDiscarded": false } ] }
  ]
}

200 — same caching headers as every data endpoint; see Caching & freshness.

#Response fields

Full field tables: Data models → Event results. Each of the four lists uses the same points[] shape (one entry per race, isDiscarded marking a dropped race under the event's discard rule); a list is [] (not omitted) if the event has no data for it — e.g. specialCategories: [] when the event defines none.

#Errors

HTTP	Code
404	`EVENT_NOT_FOUND`
401	`API_TOKEN_MISSING` / `API_TOKEN_INVALID`
403	`API_SCOPE_MISSING` / `API_IP_NOT_ALLOWED`
429	`RATE_LIMIT_EXCEEDED`
503	`API_UNAVAILABLE`

#Caching

One entry per eventId. During a live regatta this changes as races are scored (bounded by the cache window, up to an hour — see Caching & freshness); once an event is finished and awards are published it effectively stops changing.

Prompt for AI agents ready to paste into an agent

Implement getEventResults(eventId) for the Sail Club API.

GET https://sail-club-server.cloud.run/api/v1/events/{eventId}/results
Authorization: Bearer <access_token>

Success 200: { results: [...], overall: [...], ratingGroups: [...], specialCategories: [...] } — four lists,
  each entry has rank, sailNumber, boatName, skipper/owner, a score/totalScore, and points: [{ raceNo, score,
  isDiscarded, ... }]. Any list may be an empty array. Fetch GET /api/v1/openapi.json for the exact schema —
  do not invent fields not listed there.
404 EVENT_NOT_FOUND: unknown/other club's/unpublished event — not retryable.
401/403/429/503: same handling as every other call — see the full-integration prompt on /docs/overview.

Build a typed client function plus a small formatter that renders the "overall" list as a standings table:
rank, boat name, sail number, skipper, score, with discarded races shown struck through / annotated.

Adapt to your actual stack — the endpoint, path param and response shape above are language-neutral.