Results & Standings API

Retrieve race-by-race results and cumulative series standings.

Endpoints

GET/api/v1/events/:slug/results

Get race results

GET/api/v1/events/:slug/standings

Get series standings

POST/api/v1/events/:slug/races/:raceId/results

Submit race results (requires results scope)

Get Results

Retrieve results for one or more races.

GET /api/v1/events/:slug/results

Query Parameters

Parameter	Type	Required	Description
`race`	`string`	No	Filter by race ID or number
`fleet`	`string`	No	Filter by fleet ID or name
`boat`	`string`	No	Filter by boat ID or sail number

race

stringOptional

Filter by race ID or number

fleet

stringOptional

Filter by fleet ID or name

boat

stringOptional

Filter by boat ID or sail number

Example Request

curl "https://rhumby.com/api/v1/events/friday-night-spring-2026/results?race=1" \
  -H "Authorization: Bearer rhb_..."

Example Response

{
  "race": {
    "id": "race_001",
    "name": "Race 1",
    "number": 1,
    "scheduledStart": "2026-04-03T18:00:00Z",
    "actualStart": "2026-04-03T18:02:15Z",
    "status": "completed"
  },
  "results": [
    {
      "position": 1,
      "boat": {
        "id": "boat_123",
        "name": "Serendipity",
        "sail": "USA 123"
      },
      "skipper": "John Anderson",
      "fleet": "PHRF A",
      "finishTime": "2026-04-03T19:24:32Z",
      "elapsedTime": "01:24:32",
      "correctedTime": "01:22:15",
      "points": 1,
      "status": "finished"
    },
    {
      "position": 2,
      "boat": {
        "id": "boat_124",
        "name": "Wind Dancer",
        "sail": "USA 456"
      },
      "skipper": "Maria Chen",
      "fleet": "PHRF A",
      "finishTime": "2026-04-03T19:25:18Z",
      "elapsedTime": "01:25:18",
      "correctedTime": "01:23:02",
      "points": 2,
      "status": "finished"
    }
  ]
}

Get Standings

Retrieve cumulative series standings with race-by-race breakdown.

GET /api/v1/events/:slug/standings

Query Parameters

Parameter	Type	Required	Description
`fleet`	`string`	No	Filter by fleet ID or name
`includeDrops`	`boolean`	No	Show dropped races (default: true)

fleet

stringOptional

Filter by fleet ID or name

includeDrops

booleanOptional

Show dropped races (default: true)

Example Request

curl "https://rhumby.com/api/v1/events/friday-night-spring-2026/standings?fleet=PHRF%20A" \
  -H "Authorization: Bearer rhb_..."

Example Response

{
  "event": {
    "id": "evt_abc123",
    "slug": "friday-night-spring-2026",
    "name": "Friday Night Series - Spring 2026"
  },
  "scoringSystem": {
    "type": "low-point",
    "drops": 2,
    "appliedDrops": 0
  },
  "standings": [
    {
      "position": 1,
      "boat": {
        "id": "boat_123",
        "name": "Serendipity",
        "sail": "USA 123"
      },
      "skipper": "John Anderson",
      "fleet": "PHRF A",
      "totalPoints": 12,
      "netPoints": 12,
      "racesCompleted": 8,
      "raceResults": [
        { "race": 1, "points": 1, "dropped": false },
        { "race": 2, "points": 2, "dropped": false },
        { "race": 3, "points": 1, "dropped": false },
        { "race": 4, "points": 3, "dropped": false },
        { "race": 5, "points": 1, "dropped": false },
        { "race": 6, "points": 2, "dropped": false },
        { "race": 7, "points": 1, "dropped": false },
        { "race": 8, "points": 1, "dropped": false }
      ]
    }
  ]
}

Submit Results

Submit or update results for a race. Requires results scope.

POST /api/v1/events/:slug/races/:raceId/results

Request Body

{
  "actualStart": "2026-04-03T18:02:15Z",
  "status": "completed",
  "results": [
    {
      "boat": "boat_123",
      "finishTime": "2026-04-03T19:24:32Z",
      "status": "finished"
    },
    {
      "boat": "boat_124",
      "finishTime": "2026-04-03T19:25:18Z",
      "status": "finished"
    },
    {
      "boat": "boat_125",
      "status": "dnf",
      "notes": "Retired due to equipment failure"
    }
  ]
}

Result Status Values

finished - Completed the race
dnf - Did Not Finish
dns - Did Not Start
dsq - Disqualified
dnc - Did Not Compete
raf - Retired After Finish

Example Request

curl -X POST "https://rhumby.com/api/v1/events/friday-night-spring-2026/races/race_001/results" \
  -H "Authorization: Bearer rhb_..." \
  -H "Content-Type: application/json" \
  -d '{
    "actualStart": "2026-04-03T18:02:15Z",
    "status": "completed",
    "results": [...]
  }'

Corrected times and points are calculated automatically based on the fleet's handicap system. You only need to provide finish times and status.

Submitting results requires the results scope. This scope should only be granted to trusted race management tools and timing systems.

Results & Standings API

Retrieve race-by-race results and cumulative series standings.

Endpoints

GET/api/v1/events/:slug/results

Get race results

GET/api/v1/events/:slug/standings

Get series standings

POST/api/v1/events/:slug/races/:raceId/results

Submit race results (requires results scope)

Get Results

Retrieve results for one or more races.

GET /api/v1/events/:slug/results

Query Parameters

Parameter	Type	Required	Description
`race`	`string`	No	Filter by race ID or number
`fleet`	`string`	No	Filter by fleet ID or name
`boat`	`string`	No	Filter by boat ID or sail number

race

stringOptional

Filter by race ID or number

fleet

stringOptional

Filter by fleet ID or name

boat

stringOptional

Filter by boat ID or sail number

Example Request

curl "https://rhumby.com/api/v1/events/friday-night-spring-2026/results?race=1" \
  -H "Authorization: Bearer rhb_..."

Example Response

{
  "race": {
    "id": "race_001",
    "name": "Race 1",
    "number": 1,
    "scheduledStart": "2026-04-03T18:00:00Z",
    "actualStart": "2026-04-03T18:02:15Z",
    "status": "completed"
  },
  "results": [
    {
      "position": 1,
      "boat": {
        "id": "boat_123",
        "name": "Serendipity",
        "sail": "USA 123"
      },
      "skipper": "John Anderson",
      "fleet": "PHRF A",
      "finishTime": "2026-04-03T19:24:32Z",
      "elapsedTime": "01:24:32",
      "correctedTime": "01:22:15",
      "points": 1,
      "status": "finished"
    },
    {
      "position": 2,
      "boat": {
        "id": "boat_124",
        "name": "Wind Dancer",
        "sail": "USA 456"
      },
      "skipper": "Maria Chen",
      "fleet": "PHRF A",
      "finishTime": "2026-04-03T19:25:18Z",
      "elapsedTime": "01:25:18",
      "correctedTime": "01:23:02",
      "points": 2,
      "status": "finished"
    }
  ]
}

Get Standings

Retrieve cumulative series standings with race-by-race breakdown.

GET /api/v1/events/:slug/standings

Query Parameters

Parameter	Type	Required	Description
`fleet`	`string`	No	Filter by fleet ID or name
`includeDrops`	`boolean`	No	Show dropped races (default: true)

fleet

stringOptional

Filter by fleet ID or name

includeDrops

booleanOptional

Show dropped races (default: true)

Example Request

curl "https://rhumby.com/api/v1/events/friday-night-spring-2026/standings?fleet=PHRF%20A" \
  -H "Authorization: Bearer rhb_..."

Example Response

{
  "event": {
    "id": "evt_abc123",
    "slug": "friday-night-spring-2026",
    "name": "Friday Night Series - Spring 2026"
  },
  "scoringSystem": {
    "type": "low-point",
    "drops": 2,
    "appliedDrops": 0
  },
  "standings": [
    {
      "position": 1,
      "boat": {
        "id": "boat_123",
        "name": "Serendipity",
        "sail": "USA 123"
      },
      "skipper": "John Anderson",
      "fleet": "PHRF A",
      "totalPoints": 12,
      "netPoints": 12,
      "racesCompleted": 8,
      "raceResults": [
        { "race": 1, "points": 1, "dropped": false },
        { "race": 2, "points": 2, "dropped": false },
        { "race": 3, "points": 1, "dropped": false },
        { "race": 4, "points": 3, "dropped": false },
        { "race": 5, "points": 1, "dropped": false },
        { "race": 6, "points": 2, "dropped": false },
        { "race": 7, "points": 1, "dropped": false },
        { "race": 8, "points": 1, "dropped": false }
      ]
    }
  ]
}

Submit Results

Submit or update results for a race. Requires results scope.

POST /api/v1/events/:slug/races/:raceId/results

Request Body

{
  "actualStart": "2026-04-03T18:02:15Z",
  "status": "completed",
  "results": [
    {
      "boat": "boat_123",
      "finishTime": "2026-04-03T19:24:32Z",
      "status": "finished"
    },
    {
      "boat": "boat_124",
      "finishTime": "2026-04-03T19:25:18Z",
      "status": "finished"
    },
    {
      "boat": "boat_125",
      "status": "dnf",
      "notes": "Retired due to equipment failure"
    }
  ]
}

Result Status Values

finished - Completed the race
dnf - Did Not Finish
dns - Did Not Start
dsq - Disqualified
dnc - Did Not Compete
raf - Retired After Finish

Example Request

curl -X POST "https://rhumby.com/api/v1/events/friday-night-spring-2026/races/race_001/results" \
  -H "Authorization: Bearer rhb_..." \
  -H "Content-Type: application/json" \
  -d '{
    "actualStart": "2026-04-03T18:02:15Z",
    "status": "completed",
    "results": [...]
  }'

Corrected times and points are calculated automatically based on the fleet's handicap system. You only need to provide finish times and status.

Submitting results requires the results scope. This scope should only be granted to trusted race management tools and timing systems.

Results & Standings API

Results & Standings API

Endpoints

Get Results

Query Parameters

Example Request

Example Response

Get Standings

Query Parameters

Example Request

Example Response

Submit Results

Request Body

Result Status Values

Example Request

On this page

Results & Standings API

Results & Standings API

Endpoints

Get Results

Query Parameters

Example Request

Example Response

Get Standings

Query Parameters

Example Request

Example Response

Submit Results

Request Body

Result Status Values

Example Request

On this page