Sailors API
Access sailor profiles and racing history
Sailors API
The Sailors API provides access to sailor profiles, racing statistics, and performance history.
Endpoints
GET
/api/v1/sailors/:idGet sailor profile
GET
/api/v1/sailors/:id/historyGet racing history and stats
Get Sailor Profile
Retrieve a sailor's profile information.
GET /api/v1/sailors/:idExample Request
curl "https://rhumby.com/api/v1/sailors/sailor_abc123" \
-H "Authorization: Bearer rhb_..."Example Response
{
"id": "sailor_abc123",
"name": "John Anderson",
"homePort": "Sarasota, FL",
"sailNumber": "USA 123",
"primaryBoat": {
"id": "boat_123",
"name": "Serendipity",
"type": "J/105"
},
"memberOf": [
{
"id": "org_abc",
"name": "Sarasota Sailing Squadron",
"slug": "sss"
}
],
"stats": {
"totalRaces": 156,
"totalEvents": 42,
"wins": 28,
"podiums": 87,
"yearActive": 8
}
}Get Racing History
Retrieve detailed racing history and performance statistics for a sailor.
GET /api/v1/sailors/:id/historyQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
year | number | No | Filter by year |
event | string | No | Filter by event slug |
organization | string | No | Filter by organization slug |
yearnumberOptionalFilter by year
eventstringOptionalFilter by event slug
organizationstringOptionalFilter by organization slug
Example Request
curl "https://rhumby.com/api/v1/sailors/sailor_abc123/history?year=2026" \
-H "Authorization: Bearer rhb_..."Example Response
{
"sailor": {
"id": "sailor_abc123",
"name": "John Anderson"
},
"summary": {
"year": 2026,
"totalRaces": 45,
"totalEvents": 12,
"wins": 8,
"podiums": 28,
"averageFinish": 2.3
},
"events": [
{
"event": {
"id": "evt_001",
"slug": "friday-night-spring-2026",
"name": "Friday Night Series - Spring 2026"
},
"position": 1,
"points": 12,
"racesCompleted": 8,
"wins": 5,
"averageFinish": 1.5
},
{
"event": {
"id": "evt_002",
"slug": "summer-regatta-2026",
"name": "Summer Championship 2026"
},
"position": 3,
"points": 23,
"racesCompleted": 6,
"wins": 1,
"averageFinish": 3.8
}
],
"recentRaces": [
{
"date": "2026-06-26",
"event": "Friday Night Series - Spring 2026",
"race": "Race 12",
"position": 1,
"fleet": "PHRF A",
"boat": "Serendipity"
}
]
}Sailor profiles are public by default. Sailors can opt out of public statistics in their privacy settings.