Registration API
Register boats for events programmatically
Registration API
The Registration API allows you to register boats for events through your own systems.
Endpoints
POST
/api/v1/events/:slug/registerRegister a boat for an event (requires register scope)
GET
/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) |
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 |
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.