Get Upcoming Events

GET /api/calendar

This endpoint retrieves a list of upcoming calendar events that are displayed on the stats TV displays.

Query Parameters

calId

Google Calendar ID
Learn where to find this ID

Response Body

[
    {
        "name": string,
        "type": "NORMAL" | "ALL_DAY" | "STARTS_AT_BEGINNING_OF_DAY" | "GOES_TILL_END_OF_DAY",
        "start": timestamp,
        "startIso": string,
        "end": timestamp,
        "endIso": string,
        "day": timestamp,
        "dayIso": string
    },
    {...}
]

name

Event title.

type

Type of event. This determines how the event is displayed on the stats TV displays.
If type is “NORMAL”, all except the “day” and “dayIso” fields will be present.
If type is “ALL_DAY”, only the “day” and “dayIso” fields will be present.
If type is “STARTS_AT_BEGINNING_OF_DAY”, only the “end” and “endIso” fields will be present.
If type is “GOES_TILL_END_OF_DAY”, only the “start” and “startIso” fields will be present.

start

Unix Epoch format (millis). This is the time when the event starts. This will be displayed on the stats TV displays and is used to determine the order of events.

startIso

ISO 8601 formatted date string. Example: “2025-04-22T17:00:00.000-07:00”

end

Unix Epoch format (millis). This is the time when the event ends. This will be displayed on the stats TV displays and is used to determine the order of events.

endIso

ISO 8601 formatted date string. Example: “2025-04-22T17:00:00.000-07:00”

day

Unix Epoch format (millis). This is any time on the day of the event. This is used to determine the date of the event. This will be displayed on the stats TV displays and is used to determine the order of events.

dayIso

ISO 8601 formatted date string. Example: “2025-05-15T00:00:00.000-07:00”