Skip to content

Match Timeline

A span covering the regulation match period. The engine currently emits a single period=full_game row per match, anchoring every other event to match-time rather than wall-clock or frame numbers. First/second-half boundaries are reserved in the period enum but not detected today.

Category: Structure

Properties

Property Type Description Values
period str Match-period span label. Engine currently emits only full_game. full_game

Property Values

period

Match-period span label on match_timeline events.

Value Description
full_game A single span covering the entire match. Engine currently emits this and only this.

Querying

{
  "filters": [
    { "type": "match_timeline", "periods": ["first_half"] }
  ]
}

Response

Events of this type appear in the Events endpoint response:

{
  "start": 125.5,
  "end": 135.5,
  "label": "first_half",
  "event_type": "match_timeline"
}

The label is the period name (e.g., "first_half", "second_half").