List events for a specific boat

Given a boat key, lists the events the boat is associated with — typically a regatta, training camp, or season block. Use it to surface a date-and-name picker before drilling into race-level data.

boat.eventsBetween is the preferred entry point — pass a date range that matches the user's question. The unbounded boat.events exists too but can return many hundreds of entries on busy accounts, so prefer the bounded form even for wide ranges (e.g. a whole season):

query EventsForBoat($boatKey: ID!, $from: Date!, $to: Date!) {
  boat(key: $boatKey) {
    key
    name
    eventsBetween(startTime: $from, endTime: $to) {
      key
      name
      startTime
      endTime
      timezone
    }
  }
}

Variables:

{ "boatKey": "Boat_…", "from": "2026-01-01T00:00:00Z", "to": "2026-12-31T23:59:59Z" }

Alternative — across all visible boats by time range

For "show me events that overlap last month" regardless of which boat:

query EventsBetween($startTime: Date!, $endTime: Date!) {
  eventsBetween(startTime: $startTime, endTime: $endTime) {
    key
    name
    timezone
    boats { key name }
  }
}

Filter client-side by boat membership if you want a boat-scoped result.

Alternative — by calendar day

For "did anything happen on the 14th?", eventsOnDate handles the event's own timezone for you:

query EventsOnDate($date: String!) {
  eventsOnDate(date: $date) { key name timezone startTime endTime }
}

Date format is YYYY-MM-DD.

Notes

  • startTime / endTime are full ISO 8601 timestamps; convert to the event's timezone (IANA name) before rendering for the user.
  • Some events have very loose date bounds (e.g. season-long training); a narrow time range may exclude them. Widening the eventsBetween window is the right adjustment, not falling back to the unbounded boat.events.