Ball Phase

A continuous span describing whether the ball is in play, out of bounds, or in a stoppage. Carries a phase enum: in_play, out_of_bounds, in_bounds_stoppage, half_kickoff.

Category: Structure

Properties

Property	Type	Description	Values
phase	str	Ball-phase span label.	in_play, out_of_bounds, in_bounds_stoppage, half_kickoff

Property Values

phase

Ball-phase span label on ball_phase events.

Value	Description
in_play	Active gameplay. The ball is in bounds and the referee has not stopped play.
out_of_bounds	Between the ball crossing a touchline or goal-line and the restart.
in_bounds_stoppage	Play is paused but the ball is still on-pitch (e.g. foul, injury). Distinct from out_of_bounds.
half_kickoff	Single-frame kickoff anchor at the start of a period.

Querying

{
  "filters": [
    {
      "type": "event_property",
      "event_type": "ball_phase",
      "properties": [
        { "field": "phase", "eq": "in_play" }
      ]
    }
  ]
}

Response

Events of this type appear in the Events endpoint response:

{
  "start": 125.5,
  "end": 135.5,
  "label": "in_play",
  "event_type": "ball_phase"
}

The label is the phase value (e.g., "in_play", "out_of_bounds").