Events API

The Events API allows you to search for regattas, retrieve event details, and manage event information.

Endpoints

GET/api/v1/events

Search and list events

GET/api/v1/events/:slug

Get detailed event information

PUT/api/v1/events/:slug

Update an event (requires write scope)

List Events

Search for events with optional filters.

GET /api/v1/events

Query Parameters

Parameter	Type	Required	Description
`location`	`string`	No	Filter by city, state, or country (e.g., "Florida", "Sarasota")
`startDate`	`date`	No	Filter events starting on or after this date (ISO 8601 format)
`endDate`	`date`	No	Filter events ending on or before this date
`organization`	`string`	No	Filter by organization slug
`registrationOpen`	`boolean`	No	Filter by registration status
`page`	`number`	No	Page number for pagination (default: 1)
`perPage`	`number`	No	Results per page (default: 20, max: 100)

Example Request

curl "https://rhumby.com/api/v1/events?location=Florida&startDate=2026-04-01" \
  -H "Authorization: Bearer rhb_..."

Example 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": {
        "id": "org_def456",
        "name": "Sarasota Sailing Squadron",
        "slug": "sss"
      },
      "venue": "Sarasota Bay",
      "city": "Sarasota",
      "state": "FL",
      "country": "USA",
      "registrationOpen": true,
      "totalRaces": 12,
      "completedRaces": 3
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 20,
    "total": 1,
    "totalPages": 1
  }
}

Get Event Details

Retrieve detailed information about a specific event.

GET /api/v1/events/:slug

Query Parameters

Parameter	Type	Required	Description
`include`	`string`	No	Comma-separated list of resources to include: races, fleets, boats, organization

Example Request

curl "https://rhumby.com/api/v1/events/friday-night-spring-2026?include=races,fleets" \
  -H "Authorization: Bearer rhb_..."

Example Response

{
  "id": "evt_abc123",
  "slug": "friday-night-spring-2026",
  "name": "Friday Night Series - Spring 2026",
  "description": "Weekly Friday evening races on Sarasota Bay. Open to all boats with valid PHRF certificates.",
  "startDate": "2026-04-03",
  "endDate": "2026-06-26",
  "venue": "Sarasota Bay",
  "city": "Sarasota",
  "state": "FL",
  "country": "USA",
  "organization": {
    "id": "org_def456",
    "name": "Sarasota Sailing Squadron",
    "slug": "sss"
  },
  "registrationOpen": true,
  "registrationCloses": "2026-04-01T23:59:59Z",
  "entryFee": 45.00,
  "currency": "USD",
  "totalRaces": 12,
  "completedRaces": 3,
  "races": [
    {
      "id": "race_001",
      "name": "Race 1",
      "number": 1,
      "scheduledStart": "2026-04-03T18:00:00Z",
      "actualStart": "2026-04-03T18:02:15Z",
      "status": "completed",
      "course": "W4"
    }
  ],
  "fleets": [
    {
      "id": "fleet_abc",
      "name": "PHRF A",
      "description": "PHRF ratings 60-99",
      "boats": 12
    }
  ],
  "createdAt": "2026-01-15T10:00:00Z",
  "updatedAt": "2026-03-29T14:30:00Z"
}

Update Event

Update event details. Requires write scope.

PUT /api/v1/events/:slug

Request Body

{
  "name": "Friday Night Series - Spring 2026",
  "description": "Updated description",
  "registrationOpen": false,
  "registrationCloses": "2026-04-01T23:59:59Z",
  "entryFee": 50.00
}

Example Request

curl -X PUT "https://rhumby.com/api/v1/events/friday-night-spring-2026" \
  -H "Authorization: Bearer rhb_..." \
  -H "Content-Type: application/json" \
  -d '{
    "registrationOpen": false
  }'

Example Response

{
  "id": "evt_abc123",
  "slug": "friday-night-spring-2026",
  "name": "Friday Night Series - Spring 2026",
  "registrationOpen": false,
  "updatedAt": "2026-03-29T15:00:00Z"
}

Event slugs cannot be changed after creation. Use the slug consistently as the stable identifier for API calls.

Events API

The Events API allows you to search for regattas, retrieve event details, and manage event information.

Endpoints

GET/api/v1/events

Search and list events

GET/api/v1/events/:slug

Get detailed event information

PUT/api/v1/events/:slug

Update an event (requires write scope)

List Events

Search for events with optional filters.

GET /api/v1/events

Query Parameters

Parameter	Type	Required	Description
`location`	`string`	No	Filter by city, state, or country (e.g., "Florida", "Sarasota")
`startDate`	`date`	No	Filter events starting on or after this date (ISO 8601 format)
`endDate`	`date`	No	Filter events ending on or before this date
`organization`	`string`	No	Filter by organization slug
`registrationOpen`	`boolean`	No	Filter by registration status
`page`	`number`	No	Page number for pagination (default: 1)
`perPage`	`number`	No	Results per page (default: 20, max: 100)

Example Request

curl "https://rhumby.com/api/v1/events?location=Florida&startDate=2026-04-01" \
  -H "Authorization: Bearer rhb_..."

Example 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": {
        "id": "org_def456",
        "name": "Sarasota Sailing Squadron",
        "slug": "sss"
      },
      "venue": "Sarasota Bay",
      "city": "Sarasota",
      "state": "FL",
      "country": "USA",
      "registrationOpen": true,
      "totalRaces": 12,
      "completedRaces": 3
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 20,
    "total": 1,
    "totalPages": 1
  }
}

Get Event Details

Retrieve detailed information about a specific event.

GET /api/v1/events/:slug

Query Parameters

Parameter	Type	Required	Description
`include`	`string`	No	Comma-separated list of resources to include: races, fleets, boats, organization

Example Request

curl "https://rhumby.com/api/v1/events/friday-night-spring-2026?include=races,fleets" \
  -H "Authorization: Bearer rhb_..."

Example Response

{
  "id": "evt_abc123",
  "slug": "friday-night-spring-2026",
  "name": "Friday Night Series - Spring 2026",
  "description": "Weekly Friday evening races on Sarasota Bay. Open to all boats with valid PHRF certificates.",
  "startDate": "2026-04-03",
  "endDate": "2026-06-26",
  "venue": "Sarasota Bay",
  "city": "Sarasota",
  "state": "FL",
  "country": "USA",
  "organization": {
    "id": "org_def456",
    "name": "Sarasota Sailing Squadron",
    "slug": "sss"
  },
  "registrationOpen": true,
  "registrationCloses": "2026-04-01T23:59:59Z",
  "entryFee": 45.00,
  "currency": "USD",
  "totalRaces": 12,
  "completedRaces": 3,
  "races": [
    {
      "id": "race_001",
      "name": "Race 1",
      "number": 1,
      "scheduledStart": "2026-04-03T18:00:00Z",
      "actualStart": "2026-04-03T18:02:15Z",
      "status": "completed",
      "course": "W4"
    }
  ],
  "fleets": [
    {
      "id": "fleet_abc",
      "name": "PHRF A",
      "description": "PHRF ratings 60-99",
      "boats": 12
    }
  ],
  "createdAt": "2026-01-15T10:00:00Z",
  "updatedAt": "2026-03-29T14:30:00Z"
}

Update Event

Update event details. Requires write scope.

PUT /api/v1/events/:slug

Request Body

{
  "name": "Friday Night Series - Spring 2026",
  "description": "Updated description",
  "registrationOpen": false,
  "registrationCloses": "2026-04-01T23:59:59Z",
  "entryFee": 50.00
}

Example Request

curl -X PUT "https://rhumby.com/api/v1/events/friday-night-spring-2026" \
  -H "Authorization: Bearer rhb_..." \
  -H "Content-Type: application/json" \
  -d '{
    "registrationOpen": false
  }'

Example Response

{
  "id": "evt_abc123",
  "slug": "friday-night-spring-2026",
  "name": "Friday Night Series - Spring 2026",
  "registrationOpen": false,
  "updatedAt": "2026-03-29T15:00:00Z"
}

Event slugs cannot be changed after creation. Use the slug consistently as the stable identifier for API calls.

Events API

Events API

Endpoints

List Events

Query Parameters

Example Request

Example Response

Get Event Details

Query Parameters

Example Request

Example Response

Update Event

Request Body

Example Request

Example Response

On this page

Events API

Events API

Endpoints

List Events

Query Parameters

Example Request

Example Response

Get Event Details

Query Parameters

Example Request

Example Response

Update Event

Request Body

Example Request

Example Response

On this page