Shot

An attempt to score: a kick or other body contact directed at the opponent's goal, with any body part. A headed attempt on goal is shot with body_part=HEAD — intent is the more-specific feature.

Category: Ball action

Properties

Property	Type	Description	Values
body_part	str	Which body part contacted the ball. unknown is the engine-side placeholder for unmeasured rows.	head, both_hands, unknown
confidence_detection	float32	Detection confidence [0,1].	—
confidence_event	float32	Event [0,1]. Model confidence for this event class.	—
confidence_identity	float32	Identity confidence [0,1]. Null for non-actor events and for rows where the jersey/player_id was not resolved (team-only actor rows have this null).	—

Property Values

body_part

Which body part contacted the ball.

Value	Description
head	Headed contact. Includes header, flick-on, headed pass, headed clearance.
both_hands	Two-handed throw. Used for throw-in restarts (paired with set_piece=throw_in).
unknown	Engine-side placeholder for rows where body part was not measured. Distinct from a positive identification of a non-standard body part.

Querying

Using event_property filter

{
  "filters": [
    {
      "type": "event_property",
      "event_type": "shot",
      "properties": []
    }
  ]
}

Filter by property

By body_part

{
  "filters": [
    {
      "type": "event_property",
      "event_type": "shot",
      "properties": [
        { "field": "body_part", "eq": "head" }
      ]
    }
  ]
}

Filter by player

{
  "filters": [
    {
      "type": "event_property",
      "event_type": "shot",
      "properties": [],
      "players": ["0-10"]
    }
  ]
}

Filter by team

{
  "filters": [
    {
      "type": "event_property",
      "event_type": "shot",
      "properties": [],
      "teams": ["team_0"]
    }
  ]
}

Response

Events of this type appear in the Events endpoint response:

{
  "start": 125.5,
  "end": 135.5,
  "label": "shot",
  "event_type": "shot"
}