Quick Start
Make your first API call in 5 minutes
Quick Start
Get up and running with the Rhumby API in just a few minutes.
Step 1: Get Your API Key
- Log in to your Rhumby dashboard
- Navigate to Settings → API Keys
- Click Create API Key
- Give it a name (e.g., "Development")
- Select the scopes you need (start with
read) - Copy your key - it starts with
rhb_
Store your API key securely! Treat it like a password. Never commit it to version control or share it publicly.
Step 2: Make Your First Request
Let's fetch a list of upcoming events:
curl https://rhumby.com/api/v1/events \
-H "Authorization: Bearer rhb_YOUR_KEY_HERE"Response
{
"events": [
{
"id": "evt_abc123",
"slug": "friday-night-spring-2026",
"name": "Friday Night Series - Spring 2026",
"startDate": "2026-04-03",
"endDate": "2026-06-26",
"organization": {
"name": "Sarasota Sailing Squadron",
"slug": "sss"
},
"venue": "Sarasota Bay",
"registrationOpen": true
}
],
"pagination": {
"page": 1,
"perPage": 20,
"total": 1
}
}Step 3: Get Event Details
Now fetch details for a specific event using its slug:
curl https://rhumby.com/api/v1/events/friday-night-spring-2026 \
-H "Authorization: Bearer rhb_YOUR_KEY_HERE"Response
{
"id": "evt_abc123",
"slug": "friday-night-spring-2026",
"name": "Friday Night Series - Spring 2026",
"description": "Weekly Friday evening races on Sarasota Bay",
"startDate": "2026-04-03",
"endDate": "2026-06-26",
"venue": "Sarasota Bay",
"registrationOpen": true,
"races": [
{
"id": "race_001",
"name": "Race 1",
"scheduledStart": "2026-04-03T18:00:00Z",
"status": "completed"
}
],
"fleets": [
{
"id": "fleet_abc",
"name": "PHRF A",
"boats": 12
}
]
}Step 4: Fetch Standings
Get the current series standings:
curl https://rhumby.com/api/v1/events/friday-night-spring-2026/standings \
-H "Authorization: Bearer rhb_YOUR_KEY_HERE"Response
{
"standings": [
{
"position": 1,
"boat": "Serendipity",
"sail": "USA 123",
"skipper": "John Anderson",
"fleet": "PHRF A",
"points": 12,
"races": 8,
"results": [1, 2, 1, 3, 1, 2, 1, 1]
}
]
}Next Steps
Now that you've made your first API calls:
- Explore the full API reference
- Learn about authentication and scopes
- Try embedding a widget
- Check out example integrations
Use the include parameter to expand related resources in a single request. For example, ?include=races,fleets will include full race and fleet data in the event response.