Event Updates
Subscribe to real-time event updates including game state changes, scores, and timing information.
Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
| leagueIds | Array[Int] | Array of league IDs to filter events. If omitted, receives updates for all leagues your API key has access to. | No |
Response Types
EventUpdate
| Field | Type | Description |
|---|---|---|
| leagueId | Int! | League identifier for the event |
| event | Event! | Complete event data object |
| messageTimestamp | AWSTimestamp | When the message was generated |
| messageId | String | For internal usage only |
| correlationId | String | For internal usage only |
Event
| Field | Type | Description |
|---|---|---|
| eventId | Long | Unique event identifier |
| leagueId | Int! | League identifier |
| statusId | Int | Event status code (1=Pre-game, 2=Live, 3=Final, etc.) |
| statusName | String | Human-readable event status |
| seasonId | Long | Season identifier |
| seasonPartId | Long | Season part identifier (regular season, playoffs, etc.) |
| eventStart | String | Event start time in ISO 8601 format |
| eventEnd | String | Event end time in ISO 8601 format |
| gameClock | String | Current game clock display |
| periodTypeId | Int | Current period type identifier |
| periodTypeName | String | Human-readable period type name |
| overtimeNumber | Int | Number of overtime periods |
| tournamentId | Long | Tournament identifier if applicable |
| name | String | Full event name |
| eventTeams | [EventTeam] | Array of participating teams |
| partnerEventData | PartnerEventData | Partner-specific event data |
| modifiedOn | String | Last modification timestamp |
Example Subscription
subscription {
eventUpdate(leagueIds: [3, 1]) {
leagueId
event {
eventId
statusId
statusName
eventStart
gameClock
name
eventTeams {
teamId
score
sideIndex
name
}
}
messageTimestamp
}
}