Registration API
Register boats for events programmatically
Registration API
The Registration API allows you to register boats for events through your own systems.
Endpoints
/api/v1/events/:slug/registerRegister a boat for an event (requires register scope)
/api/v1/events/:slug/registrationsList registrations
Register a Boat
Submit a boat registration for an event. Requires register scope.
POST /api/v1/events/:slug/registerRequest Body
| Parameter | Type | Required | Description |
|---|---|---|---|
boat | object | Yes | Boat information |
boat.name | string | Yes | Boat name |
boat.sail | string | Yes | Sail number |
boat.type | string | Yes | Boat type/class (e.g., J/105, Catalina 27) |
boat.length | number | No | Length overall in feet |
skipper | object | Yes | Skipper information |
skipper.name | string | Yes | Skipper full name |
skipper.email | string | Yes | Skipper email address |
skipper.phone | string | No | Skipper phone number |
fleet | string | Yes | Fleet ID or name to register for |
handicap | object | No | Handicap information (if applicable) |
handicap.rating | number | No | PHRF or other handicap rating |
handicap.certificate | string | No | Certificate number |
crew | array | No | Crew members (array of name strings) |
boatobjectRequiredBoat information
boat.namestringRequiredBoat name
boat.sailstringRequiredSail number
boat.typestringRequiredBoat type/class (e.g., J/105, Catalina 27)
boat.lengthnumberOptionalLength overall in feet
skipperobjectRequiredSkipper information
skipper.namestringRequiredSkipper full name
skipper.emailstringRequiredSkipper email address
skipper.phonestringOptionalSkipper phone number
fleetstringRequiredFleet ID or name to register for
handicapobjectOptionalHandicap information (if applicable)
handicap.ratingnumberOptionalPHRF or other handicap rating
handicap.certificatestringOptionalCertificate number
crewarrayOptionalCrew members (array of name strings)
Example Request
curl -X POST "https://rhumby.com/api/v1/events/friday-night-spring-2026/register" \
-H "Authorization: Bearer rhb_..." \
-H "Content-Type: application/json" \
-d '{
"boat": {
"name": "Serendipity",
"sail": "USA 123",
"type": "J/105",
"length": 34.5
},
"skipper": {
"name": "John Anderson",
"email": "john@example.com",
"phone": "+1-941-555-1234"
},
"fleet": "PHRF A",
"handicap": {
"rating": 81,
"certificate": "PHRF-2026-12345"
},
"crew": [
"Jane Smith",
"Bob Wilson"
]
}'Example Response
{
"id": "reg_abc123",
"status": "confirmed",
"event": {
"id": "evt_abc123",
"slug": "friday-night-spring-2026",
"name": "Friday Night Series - Spring 2026"
},
"boat": {
"id": "boat_123",
"name": "Serendipity",
"sail": "USA 123"
},
"skipper": {
"name": "John Anderson",
"email": "john@example.com"
},
"fleet": "PHRF A",
"registeredAt": "2026-03-29T15:00:00Z",
"paymentStatus": "pending",
"paymentUrl": "https://rhumby.com/pay/reg_abc123"
}List Registrations
Retrieve all registrations for an event.
GET /api/v1/events/:slug/registrationsQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
fleet | string | No | Filter by fleet |
status | string | No | Filter by status: confirmed, pending, cancelled |
fleetstringOptionalFilter by fleet
statusstringOptionalFilter by status: confirmed, pending, cancelled
Example Request
curl "https://rhumby.com/api/v1/events/friday-night-spring-2026/registrations" \
-H "Authorization: Bearer rhb_..."Example Response
{
"event": {
"id": "evt_abc123",
"slug": "friday-night-spring-2026",
"name": "Friday Night Series - Spring 2026"
},
"totalRegistrations": 24,
"registrations": [
{
"id": "reg_abc123",
"boat": {
"name": "Serendipity",
"sail": "USA 123",
"type": "J/105"
},
"skipper": {
"name": "John Anderson"
},
"fleet": "PHRF A",
"status": "confirmed",
"registeredAt": "2026-03-15T10:00:00Z"
}
]
}Registration validation rules vary by event. Check the event details for requirements like handicap certificates, membership verification, or entry fees.
Registrations can be submitted before payment. Include a payment URL in your confirmation emails to complete the registration process.