Series API
Access multi-event series and championships
Series API
The Series API provides access to multi-event racing series and championships.
Endpoints
GET
/api/v1/seriesList all series
GET
/api/v1/series/:slugGet series details
List Series
Retrieve a list of racing series.
GET /api/v1/seriesQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
year | number | No | Filter by year (e.g., 2026) |
organization | string | No | Filter by organization slug |
active | boolean | No | Filter by active status (currently running series) |
Example Request
curl "https://rhumby.com/api/v1/series?year=2026" \
-H "Authorization: Bearer rhb_..."Example Response
{
"series": [
{
"id": "series_abc123",
"slug": "west-coast-phrf-championship-2026",
"name": "West Coast PHRF Championship 2026",
"year": 2026,
"organization": {
"id": "org_def456",
"name": "US Sailing",
"slug": "us-sailing"
},
"events": [
{
"id": "evt_001",
"name": "Regatta 1",
"startDate": "2026-04-15",
"venue": "San Francisco Bay"
},
{
"id": "evt_002",
"name": "Regatta 2",
"startDate": "2026-06-10",
"venue": "Newport Beach"
}
],
"totalEvents": 4,
"completedEvents": 0,
"status": "upcoming"
}
]
}Get Series Details
Retrieve detailed information about a specific series including cumulative standings.
GET /api/v1/series/:slugExample Request
curl "https://rhumby.com/api/v1/series/west-coast-phrf-championship-2026" \
-H "Authorization: Bearer rhb_..."Example Response
{
"id": "series_abc123",
"slug": "west-coast-phrf-championship-2026",
"name": "West Coast PHRF Championship 2026",
"description": "Annual championship series for PHRF-rated boats on the West Coast",
"year": 2026,
"organization": {
"id": "org_def456",
"name": "US Sailing",
"slug": "us-sailing"
},
"events": [
{
"id": "evt_001",
"slug": "regatta-1-sf",
"name": "Regatta 1",
"startDate": "2026-04-15",
"endDate": "2026-04-17",
"venue": "San Francisco Bay",
"city": "San Francisco",
"state": "CA",
"status": "upcoming"
}
],
"standings": [
{
"position": 1,
"boat": {
"id": "boat_123",
"name": "Serendipity",
"sail": "USA 123"
},
"skipper": "John Anderson",
"totalPoints": 45,
"eventsCompleted": 2,
"eventResults": [
{ "event": "Regatta 1", "position": 3, "points": 23 },
{ "event": "Regatta 2", "position": 1, "points": 22 }
]
}
],
"scoringSystem": {
"type": "cumulative-low-point",
"drops": 1,
"minimumEvents": 3
}
}Series standings are calculated across all events in the series. Check the scoringSystem field to understand how points are calculated and which events can be dropped.