JSON Schema
- Viewer
- Schema
Loading ....
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://sports-data-platform.com/schemas/basketball-events-v2.json",
"title": "Basketball Universal Event Schema",
"description": "This document describes the data contracts of the universal events feed for basketball events",
"version": "v2",
"type": "object",
"definitions": {
"BaseEvent": {
"type": "object",
"title": "Base event",
"description": "Base schema for all sport events, capturing metadata like source, time, and sequence for tracking",
"required": [
"version",
"source",
"traceId",
"id",
"fixtureId",
"period",
"eventType",
"competitors",
"participants",
"audit",
"tags",
"additionalAttributes"
],
"discriminator": "eventType",
"properties": {
"version": {
"type": "string",
"description": "Semantic version of event",
"example": "0.1.0"
},
"source": {
"$ref": "#/definitions/EventSource"
},
"traceId": {
"type": "string",
"description": "Unique identifier provided by collection tool run to trace the event.",
"example": "c1c4b4ac-968c-4ef6-966c-32f7993777aa"
},
"id": {
"type": "string",
"description": "Unique identifier of event instance",
"example": "849819d8-7a2a-4dcf-9697-45994094348c"
},
"insertedBeforeEventId": {
"type": "string",
"description": "Unique identifier of event instance this event should be inserted before in a correction",
"example": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6"
},
"fixtureId": {
"type": "string",
"description": "Unique identifier of fixture that event occurred. Provided by Fixtures API",
"example": "3788a836-5148-425b-966e-8f96e7396a19"
},
"period": {
"$ref": "#/definitions/Period"
},
"eventType": {
"$ref": "#/definitions/EventType"
},
"startGameClock": {
"type": "integer",
"format": "int64",
"description": "Game clock value of moment, when event started to occur. Must be provided in milliseconds.",
"example": 580200
},
"endGameClock": {
"type": "integer",
"format": "int64",
"description": "Game clock value of moment, when event finished to occur. Must be provided in milliseconds.",
"example": 580200
},
"competitors": {
"type": "array",
"description": "List of competitors, who participated in a sport event.",
"items": {
"$ref": "#/definitions/Competitor"
}
},
"participants": {
"type": "array",
"description": "List of participants, who participated in a sport event.",
"items": {
"$ref": "#/definitions/Participant"
}
},
"audit": {
"$ref": "#/definitions/AuditFields"
},
"tags": {
"type": "object",
"description": "A collection of tags provided by collection tools."
},
"additionalAttributes": {
"type": "object",
"description": "Additional, non-standard attributes provided by collection tools."
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "SHOT",
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "SHOOTER"
}
],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"EventSource": {
"type": "string",
"description": "Defines event feed source",
"enum": [
"UNKNOWN",
"GeniusSportsInPlay",
"GeniusInPlay",
"GeniusLiveStats",
"GeniusScoresheet"
],
"examples": [
"GeniusLiveStats"
],
"default": "UNKNOWN"
},
"AuditFields": {
"type": "object",
"title": "Universal feed event",
"description": "Defines metadata attributes for universal feed event, which are not specific to any sport",
"required": [
"sequenceNumber",
"createdUtc",
"publishedUtc",
"confidence"
],
"properties": {
"sequenceNumber": {
"type": "integer",
"description": "Event sequence number to track if any events were missed to receive. Always incremented by one."
},
"startUtc": {
"type": "integer",
"format": "int64",
"description": "Event start time in UTC timezone. Must be provided in UNIX date-time representation (milliseconds)."
},
"endUtc": {
"type": "integer",
"format": "int64",
"description": "Event end time in UTC timezone. Must be provided in UNIX date-time representation (milliseconds)"
},
"createdUtc": {
"type": "integer",
"format": "int64",
"description": "Event creation time in UTC timezone. Must be provided in UNIX date-time representation (milliseconds)"
},
"updatedUtc": {
"type": "integer",
"format": "int64",
"description": "Event update time in UTC timezone. Must be provided in UNIX date-time representation (milliseconds)"
},
"insertedUtc": {
"type": "integer",
"format": "int64",
"description": "Event insertion time in UTC timezone. Must be provided in UNIX date-time representation (milliseconds)"
},
"deletedUtc": {
"type": "integer",
"format": "int64",
"description": "Event deletion time in UTC timezone. Must be provided in UNIX date-time representation (milliseconds)"
},
"publishedUtc": {
"type": "integer",
"format": "int64",
"description": "Event publish time in UTC timezone. Must be provided in UNIX date-time representation (milliseconds)"
},
"confirmedUtc": {
"type": "integer",
"format": "int64",
"description": "Event confirmation time in UTC timezone. Must be provided in UNIX date-time representation (milliseconds)"
},
"startFrameIdx": {
"$ref": "#/definitions/FrameIdx"
},
"endFrameIdx": {
"$ref": "#/definitions/FrameIdx"
},
"confidence": {
"$ref": "#/definitions/Confidence"
},
"externalIds": {
"$ref": "#/definitions/ExternalIds"
}
},
"examples": [
{
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
}
]
},
"ExternalIds": {
"type": "object",
"properties": {
"externalId": {
"type": "string"
},
"externalIdType": {
"type": "string"
}
},
"example": {
"externalId": "123-456",
"externalIdType": "DragonRunId"
}
},
"FrameIdx": {
"type": "integer",
"format": "int32"
},
"EventAttributes": {
"type": "object"
},
"Confidence": {
"type": "object",
"title": "Confidence",
"description": "Defines confidence (reliability) attributes, which can be set by collection or aggregation tools",
"properties": {
"score": {
"type": "number",
"format": "float",
"minimum": 0,
"maximum": 1,
"description": "Confidence level expressed in scale of 0.0 - 1.0"
},
"flagged": {
"type": "boolean",
"description": "Defines, whether the particular event is flagged by collection tool."
}
},
"examples": [
{
"score": 1,
"flagged": false
}
]
},
"BasketballEvent": {
"title": "Basketball event",
"description": "Represents a base Basketball Event.",
"allOf": [
{
"$ref": "#/definitions/BaseEvent"
}
],
"type": "object"
},
"EventType": {
"title": "Event type",
"description": "Enumerates all supported basketball event types such as fouls, shots, timeouts, and others",
"type": "string",
"enum": [
"UNKNOWN",
"CHALLENGE",
"CLOCK",
"FOUL",
"FREE_THROW",
"JUMP_BALL",
"MATCH_STATUS_CHANGE",
"PARTICIPATION",
"PERIOD_TRANSITION",
"PROTEST",
"SHOT",
"SUBSTITUTION",
"TIMEOUT",
"TURNOVER",
"REBOUND",
"RELIABILITY",
"LINEUP",
"POSSESSION_CHANGE",
"POSSESSION_ARROW_CHANGE"
],
"default": "UNKNOWN"
},
"Period": {
"title": "Period",
"description": "Defines period attributes, which uniquely identifies period",
"type": "object",
"required": [
"number",
"type"
],
"properties": {
"type": {
"$ref": "#/definitions/PeriodType"
},
"number": {
"description": "Period sequence number, which is reset for each period type",
"type": "integer",
"format": "int32"
},
"status": {
"$ref": "#/definitions/PeriodStatus"
}
},
"examples": [
{
"type": "REGULAR",
"number": 1,
"status": "IN_PROGRESS"
}
]
},
"PeriodType": {
"title": "Period type",
"description": "Defines possible values for period type",
"type": "string",
"enum": [
"UNKNOWN",
"PREGAME",
"REGULAR",
"OVERTIME"
],
"examples": [
"REGULAR"
],
"default": "UNKNOWN"
},
"PeriodStatus": {
"title": "Period status",
"description": "Defines possible values for period status",
"type": "string",
"enum": [
"UNKNOWN",
"PENDING",
"IN_PROGRESS",
"FINISHED"
],
"examples": [
"IN_PROGRESS"
],
"default": "UNKNOWN"
},
"Competitor": {
"type": "object",
"title": "Competitor",
"description": "Defines competitor, who issued the sport action",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier of a competitor"
},
"type": {
"$ref": "#/definitions/CompetitorType"
}
},
"examples": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
]
},
"CompetitorType": {
"type": "string",
"title": "Competitor type",
"description": "Classifies the role a competitor plays in an event.",
"enum": [
"UNKNOWN",
"HOME",
"AWAY"
],
"examples": [
"HOME"
],
"default": "UNKNOWN"
},
"Participant": {
"type": "object",
"title": "Participant descriptor",
"description": "Defines participants, which participated in the sport action with their respective competitor included",
"required": [
"id",
"competitorId",
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier of participant"
},
"competitorId": {
"type": "string",
"description": "Unique identifier of competitor"
},
"type": {
"$ref": "#/definitions/ParticipantType"
}
},
"examples": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "SHOOTER"
}
]
},
"ParticipantType": {
"type": "string",
"title": "Participant type",
"description": "Classifies the role a participant plays in an event, such as SHOOTER, REBOUNDER, etc.",
"enum": [
"UNKNOWN",
"SHOOTER",
"FOUL_BY",
"FOUL_ON",
"ASSISTER",
"BLOCKER",
"REBOUNDER",
"TURNOVER_BY",
"STEALER",
"PARTICIPANT",
"WON_BY",
"LOST_BY",
"SUBSTITUTED_IN",
"SUBSTITUTED_OUT"
],
"examples": [
"SHOOTER"
],
"default": "UNKNOWN"
},
"ClockEvent": {
"title": "Clock event",
"description": "Defines clock event",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/ClockAttributes"
}
},
"example": {
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "CLOCK",
"attributes": {
"status": "STARTED",
"fromDevice": true,
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [],
"participants": [],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
},
"ClockAttributes": {
"title": "Clock attributes",
"description": "Defines clock attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"status": {
"$ref": "#/definitions/ClockStatusType",
"description": "Defines possible values for clock status"
},
"fromDevice": {
"type": "boolean",
"description": "Specifies if the clock information are from an external device"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"required": [
"status"
],
"examples": [
{
"status": "STARTED",
"fromDevice": true,
"isCompleted": true
}
]
},
"ClockStatusType": {
"title": "Clock status",
"description": "Defines possible values for clock status",
"type": "string",
"enum": [
"UNKNOWN",
"STARTED",
"STOPPED",
"ADJUSTED"
],
"examples": [
"STARTED"
],
"default": "UNKNOWN"
},
"FoulEvent": {
"title": "Foul event",
"description": "Defines foul event",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/FoulAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "FOUL",
"attributes": {
"shotClock": 23200,
"wallClock": 1234567890,
"freeThrowsAwarded": 2,
"type": "PERSONAL",
"qualifiers": [
"DIRECT",
"GAME_DISQUALIFICATION"
],
"hasFoulOn": true,
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "FOUL_BY"
},
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "FOUL_ON"
}
],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"FoulAttributes": {
"title": "Foul attributes",
"description": "Defines foul attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"freeThrowsAwarded": {
"description": "Number of free throws awarded because of the foul",
"type": "integer"
},
"type": {
"$ref": "#/definitions/FoulType"
},
"qualifiers": {
"description": "List of qualifiers that additionally describe the foul event",
"type": "array",
"items": {
"$ref": "#/definitions/FoulQualifier"
}
},
"hasFoulOn": {
"description": "Identifies whether FoulOn participant is present, null when unknown.",
"type": "boolean"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"freeThrowsAwarded": 2,
"type": "BENCH",
"qualifiers": [
"DIRECT",
"GAME_DISQUALIFICATION"
],
"hasFoulOn": true,
"isCompleted": true
}
]
},
"FoulType": {
"title": "Foul type",
"description": "Defines applicable foul types",
"type": "string",
"enum": [
"UNKNOWN",
"OFFENSIVE",
"PERSONAL",
"TECHNICAL",
"DISQUALIFYING",
"UNSPORTSMANLIKE",
"INTENTIONAL",
"THROW_IN",
"BENCH",
"COACH"
],
"examples": [
"BENCH"
],
"default": "UNKNOWN"
},
"FoulQualifier": {
"title": "Foul qualifier",
"description": "Defines applicable qualifiers for foul",
"type": "string",
"enum": [
"UNKNOWN",
"CLASS_A",
"CLASS_B",
"DIRECT",
"INDIRECT",
"GAME_DISQUALIFICATION",
"FIGHTING",
"CANCELLED_FREE_THROWS",
"ONE_AND_ONE"
],
"examples": [
"DIRECT"
],
"default": "UNKNOWN"
},
"FreeThrowEvent": {
"title": "Free throw event",
"description": "Defines free throw event",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/FreeThrowAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "FREE_THROW",
"attributes": {
"shotClock": 23200,
"wallClock": 1234567890,
"points": 1,
"isSuccessful": true,
"attemptSequence": 1,
"qualifiers": [
"FAST_BREAK",
"FROM_TURNOVER"
],
"foulId": "123e4567-e89b-12d3-a456-426614174000",
"hasAssister": true,
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "SHOOTER"
},
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "ASSISTER"
}
],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"FreeThrowAttributes": {
"title": "Free throw attributes",
"description": "Defines free throw attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"required": [
"isSuccessful",
"points"
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"points": {
"description": "Amount of points the free-throw can provide",
"type": "integer"
},
"isSuccessful": {
"description": "Specifies if the free-throw was made",
"type": "boolean"
},
"attemptSequence": {
"description": "Free-throw attempt sequence number",
"type": "integer"
},
"qualifiers": {
"description": "List of qualifiers that additionally describe the free-throw event",
"type": "array",
"items": {
"$ref": "#/definitions/FreeThrowQualifier"
}
},
"foulId": {
"description": "ID of the foul event, which caused free-throws",
"type": "string"
},
"hasAssister": {
"description": "Identifies whether Assister participant is present, null when unknown.",
"type": "boolean"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"points": 1,
"isSuccessful": true,
"attemptSequence": 1,
"qualifiers": [
"FAST_BREAK",
"FROM_TURNOVER"
],
"foulId": "123e4567-e89b-12d3-a456-426614174000",
"hasAssister": true,
"isCompleted": true
}
]
},
"FreeThrowQualifier": {
"title": "Free-throw qualifier",
"description": "Defines applicable qualifiers for free-throw",
"type": "string",
"enum": [
"UNKNOWN",
"SECOND_CHANCE",
"FAST_BREAK",
"FROM_TURNOVER"
],
"examples": [
"FAST_BREAK"
],
"default": "UNKNOWN"
},
"ParticipationEvent": {
"title": "Participation event",
"description": "Defines participation event",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"type": "object",
"properties": {
"attributes": {
"$ref": "#/definitions/ParticipationAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "PARTICIPATION",
"attributes": {
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567891",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "PARTICIPANT"
},
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567892",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "PARTICIPANT"
},
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567893",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "PARTICIPANT"
}
],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"ParticipationAttributes": {
"title": "Participation attributes",
"description": "Defines participation attributes.",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"isCompleted": true
}
]
},
"PeriodTransitionEvent": {
"title": "Period transition event",
"description": "Defines period transition event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/PeriodTransitionAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "PERIOD_TRANSITION",
"attributes": {
"shotClock": 24000,
"wallClock": 1752448658000,
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [],
"participants": [],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"PeriodTransitionAttributes": {
"title": "Period transition event",
"description": "Defines period-transition attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"isCompleted": true
}
]
},
"ShotEvent": {
"title": "Shot event",
"description": "Defines shot event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/ShotAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "SHOT",
"attributes": {
"points": 2,
"isSuccessful": true,
"attemptSequence": 1,
"qualifiers": [
"FAST_BREAK",
"FROM_TURNOVER"
],
"hasAssister": true,
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567891",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "SHOOTER"
},
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567892",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "ASSISTER"
}
],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
},
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "SHOT",
"attributes": {
"points": 2,
"isSuccessful": false,
"attemptSequence": 1,
"qualifiers": [
"FAST_BREAK",
"FROM_TURNOVER"
],
"hasBlocker": true,
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567891",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "SHOOTER"
},
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef12345678a2",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789013",
"type": "BLOCKER"
}
],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"ShotAttributes": {
"title": "Shot attributes",
"description": "Defines shot attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"required": [
"isSuccessful",
"points"
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"points": {
"description": "Amount of points the shot can provide",
"type": "integer"
},
"isSuccessful": {
"description": "Specifies if the shot was made",
"type": "boolean"
},
"type": {
"$ref": "#/definitions/ShotType"
},
"qualifiers": {
"type": "array",
"items": {
"$ref": "#/definitions/ShotQualifier"
}
},
"hasAssister": {
"description": "Identifies whether Assister participant is present, null when unknown.",
"type": "boolean"
},
"hasBlocker": {
"description": "Identifies whether Blocker participant is present, null when unknown.",
"type": "boolean"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"points": 2,
"isSuccessful": true,
"type": "JUMP_SHOT",
"qualifiers": [
"SECOND_CHANCE",
"FROM_TURNOVER"
],
"hasAssister": true,
"hasBlocker": false,
"isCompleted": true
}
]
},
"ShotType": {
"title": "Shot type",
"description": "Defines possible shot types",
"type": "string",
"enum": [
"UNKNOWN",
"DUNK",
"LAYUP",
"FADEAWAY",
"TIP_IN_DUNK",
"TIP_IN_LAYUP",
"JUMP_SHOT",
"ALLEY_OOP",
"DRIVING_LAYUP",
"HOOK_SHOT",
"FLOATING_JUMP_SHOT",
"STEPBACK_JUMP_SHOT",
"PULLUP_JUMP_SHOT",
"TURNAROUND_JUMP_SHOT",
"WRONG_BASKET",
"REVERSE_LAYUP",
"EURO_STEP",
"ALLEY_OOP_DUNK"
],
"examples": [
"JUMP_SHOT"
],
"default": "UNKNOWN"
},
"ShotQualifier": {
"title": "Shot qualifier",
"description": "Defines possible shot qualifiers",
"type": "string",
"enum": [
"UNKNOWN",
"SECOND_CHANCE",
"FAST_BREAK",
"FROM_TURNOVER",
"POINTS_IN_THE_PAINT",
"BLOCKED"
],
"examples": [
"SECOND_CHANCE"
],
"default": "UNKNOWN"
},
"SubstitutionEvent": {
"title": "Substitution event",
"description": "Defines substitution event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/SubstitutionAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "SUBSTITUTION",
"attributes": {
"shotClock": 23200,
"wallClock": 1234567890,
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567891",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "SUBSTITUTED_IN"
},
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567892",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "SUBSTITUTED_OUT"
},
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567893",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "SUBSTITUTED_IN"
},
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567894",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "SUBSTITUTED_OUT"
}
],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"SubstitutionAttributes": {
"title": "Substitution attributes",
"description": "Defines substitution attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"isCompleted": true
}
]
},
"TimeoutEvent": {
"title": "Timeout event",
"description": "Defines timeout event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/TimeoutAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "TIMEOUT",
"attributes": {
"shotClock": 23200,
"wallClock": 1234567890,
"type": "FULL",
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"TimeoutAttributes": {
"title": "Timeout event",
"description": "Defines timeout attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"type": {
"$ref": "#/definitions/TimeoutType"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"type": "FULL",
"isCompleted": true
}
]
},
"TimeoutType": {
"title": "Timeout type",
"description": "Defines possible timeout types",
"type": "string",
"enum": [
"UNKNOWN",
"FULL",
"SHORT",
"OFFICIALS",
"MEDIA",
"COMMERCIALS"
],
"examples": [
"FULL"
],
"default": "UNKNOWN"
},
"ChallengeEvent": {
"title": "Challenge event",
"description": "Defines challenge event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/ChallengeAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "CHALLENGE",
"attributes": {
"shotClock": 23200,
"wallClock": 1234567890,
"reason": "TWO_POINTS",
"outcome": "SUCCESSFUL",
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"ChallengeAttributes": {
"title": "Challenge event",
"description": "Defines challenge attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"reason": {
"$ref": "#/definitions/ChallengeReason"
},
"outcome": {
"$ref": "#/definitions/ChallengeOutcome"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"reason": "TWO_POINTS",
"outcome": "SUCCESSFUL",
"isCompleted": true
}
]
},
"ChallengeReason": {
"title": "Challenge reason",
"description": "Defines possible values for challenge reason",
"type": "string",
"enum": [
"UNKNOWN",
"CLOCK",
"TWO_POINTS",
"THREE_POINTS",
"FREE_THROW_SHOOTER",
"OUT_OF_BOUNDS",
"FOUL",
"GOAL_TENDING",
"VIOLENCE"
],
"examples": [
"TWO_POINTS"
],
"default": "UNKNOWN"
},
"ChallengeOutcome": {
"title": "Challenge outcome",
"description": "Defines possble challenge outcomes",
"type": "string",
"enum": [
"UNKNOWN",
"SUCCESSFUL",
"UNSUCCESSFUL"
],
"examples": [
"SUCCESSFUL"
],
"default": "UNKNOWN"
},
"ProtestEvent": {
"title": "Protest event",
"description": "Defines protest event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/ProtestAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "PROTEST",
"attributes": {
"shotClock": 23200,
"wallClock": 1234567890,
"reason": "SCOREKEEPING",
"description": "This is an example description",
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"ProtestAttributes": {
"title": "Protest attributes",
"description": "Defines protest attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"reason": {
"$ref": "#/definitions/ProtestReason"
},
"description": {
"description": "Free-text description of the protest",
"type": "string"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"reason": "SCOREKEEPING",
"description": "This is an example description",
"isCompleted": true
}
]
},
"ProtestReason": {
"title": "Protest reason",
"description": "Classifies possible protest reasons",
"type": "string",
"enum": [
"UNKNOWN",
"SCOREKEEPING",
"TIMEKEEPING",
"SHOT_CLOCK",
"OTHER"
],
"examples": [
"SCOREKEEPING"
],
"default": "UNKNOWN"
},
"ReboundEvent": {
"title": "Rebound event",
"description": "Defines rebound event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/ReboundAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "CLOCK",
"attributes": {
"shotClock": 23200,
"wallClock": 1234567890,
"shotId": "c3d4e5f6-g7h8-9012-cdef-345678901234",
"freeThrowId": "c3d4e5f6-g7h8-9012-cdef-345678901234",
"type": "DEFENSIVE",
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "REBOUNDER"
}
],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"ReboundAttributes": {
"title": "Rebound attributes",
"description": "Defines rebound attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"shotId": {
"description": "ID of the shot event, which resulted in given rebound",
"type": "string"
},
"freeThrowId": {
"description": "ID of the free throw event, which resulted in given rebound",
"type": "string"
},
"type": {
"$ref": "#/definitions/ReboundType"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"shotId": "c3d4e5f6-g7h8-9012-cdef-345678901234",
"freeThrowId": "c3d4e5f6-g7h8-9012-cdef-345678901234",
"type": "DEFENSIVE",
"isCompleted": true
}
]
},
"ReboundType": {
"title": "Rebound type",
"description": "Classifies possible rebound types",
"type": "string",
"enum": [
"UNKNOWN",
"DEFENSIVE",
"OFFENSIVE",
"DEFENSIVE_DEADBALL",
"OFFENSIVE_DEADBALL"
],
"examples": [
"DEFENSIVE"
],
"default": "UNKNOWN"
},
"TurnoverEvent": {
"title": "Turnover event",
"description": "Defines turnover event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/TurnoverAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "TURNOVER",
"attributes": {
"shotClock": 23200,
"wallClock": 1234567890,
"type": "BAD_PASS",
"hasStealer": true,
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "TURNOVER_BY"
},
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "STEALER"
}
],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"TurnoverAttributes": {
"title": "Turnover attributes",
"description": "Defines turnover attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"hasStealer": {
"description": "Identifies whether Stealer participant is present, null when unknown.",
"type": "boolean"
},
"type": {
"$ref": "#/definitions/TurnoverType"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"hasStealer": true,
"type": "BACK_COURT",
"isCompleted": true
}
]
},
"TurnoverType": {
"title": "Turnover type",
"description": "Defines turnover types",
"type": "string",
"enum": [
"UNKNOWN",
"BACK_COURT",
"BACK_COURT_TIME_VIOLATION",
"BAD_PASS",
"BALL_HANDLING",
"DOUBLE_DRIBBLE",
"FIVE_SECONDS",
"FREE_THROW_LANE_VIOLATION",
"JUMP_BALL",
"NONE",
"OFFENSIVE",
"OFFENSIVE_GOAL_TENDING",
"OTHER",
"OUT_OF_BOUNDS",
"SHOT_CLOCK",
"THREE_SECONDS",
"TRAVEL"
],
"examples": [
"BACK_COURT"
],
"default": "UNKNOWN"
},
"JumpBallEvent": {
"title": "Jump ball event",
"description": "Defines jump ball event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/JumpBallAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "JUMP_BALL",
"attributes": {
"shotClock": 23200,
"wallClock": 1234567890,
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "WON_BY"
},
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567891",
"competitorId": "b2c3d4e5-f6g7-8901-bcde-f23456789013",
"type": "LOST_BY"
}
],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"JumpBallAttributes": {
"title": "Jump ball event attributes",
"description": "Defines jump ball attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"isCompleted": true
}
]
},
"LineupEvent": {
"title": "Lineup event",
"description": "Defines lineup event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/LineupAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "LINEUP",
"attributes": {
"lineup": [
{
"id": "c3d4e5f6-g7h8-9012-cdef-345678901234",
"isStarter": true
}
],
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"LineupAttributes": {
"title": "Lineup event attributes",
"description": "Defines lineup attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"required": [
"lineup"
],
"properties": {
"lineup": {
"type": "array",
"description": "List of lineup participants.",
"items": {
"$ref": "#/definitions/LineupParticipant"
}
}
},
"examples": [
{
"lineup": [
{
"id": "c3d4e5f6-g7h8-9012-cdef-345678901234",
"isStarter": true
}
]
}
]
},
"LineupParticipant": {
"title": "Lineup participant",
"description": "Defines lineup participant",
"type": "object",
"required": [
"id",
"isStarter"
],
"properties": {
"id": {
"type": "string"
},
"isStarter": {
"type": "boolean"
}
},
"examples": [
{
"id": "c3d4e5f6-g7h8-9012-cdef-345678901234",
"isStarter": true
}
]
},
"MatchStatusChangeEvent": {
"title": "Match status change event",
"description": "Defines match status change event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/MatchStatusChangeAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "MATCH_STATUS_CHANGE",
"attributes": {
"status": "IN_PROGRESS",
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [],
"participants": [],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"MatchStatusChangeAttributes": {
"title": "Match status change event attributes",
"description": "Defines match status change attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"required": [
"status"
],
"properties": {
"status": {
"$ref": "#/definitions/MatchStatus"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"status": "IN_PROGRESS",
"isCompleted": true
}
]
},
"MatchStatus": {
"title": "Match status",
"description": "Defines possible values for match status",
"type": "string",
"enum": [
"UNKNOWN",
"NOT_STARTED",
"WARMUP",
"IN_PROGRESS",
"FINISHED",
"INTERRUPTED",
"CANCELLED",
"ABANDONED"
],
"examples": [
"IN_PROGRESS"
],
"default": "UNKNOWN"
},
"PossessionChangeEvent": {
"title": "Possession change event",
"description": "Defines possession change event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/PossessionChangeAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "POSSESSION_CHANGE",
"attributes": {
"shotClock": 23200,
"wallClock": 1234567890,
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"PossessionChangeAttributes": {
"title": "Possession change attributes",
"description": "Defines possession change attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"isCompleted": true
}
]
},
"PossessionArrowChangeEvent": {
"title": "Possession arrow change event",
"description": "Defines possession arrow change event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/PossessionChangeAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "POSSESSION_ARROW_CHANGE",
"attributes": {
"shotClock": 23200,
"wallClock": 1234567890,
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [
{
"id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
"type": "HOME"
}
],
"participants": [],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"PossessionArrowChangeAttributes": {
"title": "Possession arrow change attributes",
"description": "Defines possession arrow change attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"shotClock": {
"type": "integer",
"format": "int64",
"description": "Shot clock value of moment, when event occurred. Must be provided in milliseconds."
},
"wallClock": {
"type": "integer",
"format": "int64",
"description": "UTC timestamp of moment (relative to the game), when event occurred. Must be provided in UNIX date-time representation (milliseconds)"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"shotClock": 23200,
"wallClock": 1234567890,
"isCompleted": true
}
]
},
"ReliabilityEvent": {
"title": "Reliability event",
"description": "Defines changes of reliability event",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/BasketballEvent"
}
],
"properties": {
"attributes": {
"$ref": "#/definitions/ReliabilityAttributes"
}
},
"examples": [
{
"version": "0.1.0",
"source": "GeniusLiveStats",
"traceId": "c1c4b4ac-968c-4ef6-966c-32f7993777aa",
"id": "849819d8-7a2a-4dcf-9697-45994094348c",
"insertedBeforeEventId": "67882a7a-6b12-4db2-bb69-79e50c1d7fd6",
"fixtureId": "3788a836-5148-425b-966e-8f96e7396a19",
"period": {
"number": 1,
"type": "REGULAR",
"status": "IN_PROGRESS"
},
"eventType": "CLOCK",
"attributes": {
"isReliabile": true,
"reason": "RELIABLE",
"isCompleted": true
},
"startGameClock": 580200,
"endGameClock": 580200,
"competitors": [],
"participants": [],
"audit": {
"sequenceNumber": 1,
"startUtc": 1752448658000,
"endUtc": 1752448658000,
"createdUtc": 1752448658000,
"updatedUtc": 1752448658000,
"insertedUtc": 1752448658000,
"deletedUtc": 1752448658000,
"publishedUtc": 1752448658000,
"confirmedUtc": 1752448658000,
"confidence": {
"score": 1,
"flagged": false
}
},
"tags": {
"highlight": true
},
"additionalAttributes": {
"courtArea": "LEFT_WING"
}
}
]
},
"ReliabilityAttributes": {
"title": "Relibility attributes",
"description": "Defines reliability attributes",
"type": "object",
"allOf": [
{
"$ref": "#/definitions/EventAttributes"
}
],
"properties": {
"isReliabile": {
"type": "boolean",
"description": "Indicates if the feed is reliabile"
},
"reason": {
"type": "string",
"description": "Indicate the reliability reason"
},
"isCompleted": {
"type": "boolean",
"description": "Indicates whether the statistician has collected all available data during regular workflow. For example: when there are no more data points to be added for a shot."
}
},
"examples": [
{
"isReliabile": true,
"reason": "RELIABLE",
"isCompleted": true
}
]
}
},
"oneOf": [
{
"$ref": "#/definitions/ChallengeEvent"
},
{
"$ref": "#/definitions/ClockEvent"
},
{
"$ref": "#/definitions/FreeThrowEvent"
},
{
"$ref": "#/definitions/FoulEvent"
},
{
"$ref": "#/definitions/JumpBallEvent"
},
{
"$ref": "#/definitions/LineupEvent"
},
{
"$ref": "#/definitions/MatchStatusChangeEvent"
},
{
"$ref": "#/definitions/ParticipationEvent"
},
{
"$ref": "#/definitions/PeriodTransitionEvent"
},
{
"$ref": "#/definitions/PossessionChangeEvent"
},
{
"$ref": "#/definitions/PossessionArrowChangeEvent"
},
{
"$ref": "#/definitions/ProtestEvent"
},
{
"$ref": "#/definitions/ReboundEvent"
},
{
"$ref": "#/definitions/ReliabilityEvent"
},
{
"$ref": "#/definitions/ShotEvent"
},
{
"$ref": "#/definitions/SubstitutionEvent"
},
{
"$ref": "#/definitions/TimeoutEvent"
},
{
"$ref": "#/definitions/TurnoverEvent"
}
]
}