> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uplift.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Shot

> An attempt on goal.

> [!WARNING]
>
> The Game Data API is in preview. Endpoints, fields and limits may change before release, and it is not yet available to call.

## Technical Details

* **Variable Type:** Event
* **Event Type:** `shot`
* **Subtypes:** None
* **Layer:** `ball` (ball and player positions)
* **Returned By:** [List Game Events](https://docs.uplift.ai/api-reference/game-data/events/list.md)
* **Filter:** `event_type=shot`

## Description

An attempt on goal.

Every event has the same envelope fields, including time, frames, player, team, pitch coordinates, `phase`, `team_possession_id`, `player_possession_id` and `confidence`. See [List Game Events](https://docs.uplift.ai/api-reference/game-data/events/list.md). The fields below are specific to this type and are returned in `attributes`.

## Attributes

| Field | Units | Description |
| - | - | - |
| `outcome` | — | Result of the shot, for example `goal` or `on_target`. |
| `distance_to_goal_m` | m | Distance from the shot to the centre of the goal. |
| `angle_deg` | ° | Angle of the shot to the goal. |
| `ball_speed_kmh` | km/h | Speed of the ball. |
| `body_part` | — | Body part the shot was taken with, for example `right_foot`. |
| `defenders_between` | count | Defenders between the ball and the goal. |
| `xg` | — | Expected goals. Can be `null`. |
| `assist_player_id` | — | For a goal, the player who made the assist. Can be `null`. |

## Example

Only the type-specific fields and a few envelope fields are shown.

```json theme={null}
{
  "event_type": "shot",
  "attributes": {
    "outcome": "on_target",
    "distance_to_goal_m": 17.5,
    "angle_deg": 24,
    "ball_speed_kmh": 92.0,
    "body_part": "right_foot",
    "defenders_between": 2,
    "xg": null,
    "assist_player_id": null
  }
}
```

## Related

* [Key Moment](https://docs.uplift.ai/api-reference/game-data/event-catalogue/segments/key-moment)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.