> ## 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.

# Set Piece

> Throw-ins, corners, goal kicks, free kicks, penalties and kick-offs.

> [!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:** `set_piece`
* **Subtypes:** `throw_in`, `corner`, `goal_kick`, `free_kick`, `penalty`, `kick_off`
* **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=set_piece`

## Description

A restart: a throw-in, corner, goal kick, free kick, penalty or kick-off. The subtype says which.

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 |
| - | - | - |
| `taker_player_id` | — | Player who took the set piece. |
| `delivery` | — | How the ball was delivered, for example `inswinging`. |
| `first_contact_team` | — | `home` or `away`: the team that touched the ball first after the delivery. |
| `first_contact_player_id` | — | First player to touch the ball after the delivery. |
| `ended_with` | — | How the set piece ended, for example `shot`. |

## Example

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

```json theme={null}
{
  "event_type": "set_piece",
  "event_subtype": "corner",
  "attributes": {
    "taker_player_id": "p11",
    "delivery": "inswinging",
    "first_contact_team": "home",
    "first_contact_player_id": "p05",
    "ended_with": "shot"
  }
}
```

## Related

* [Phase of Play](https://docs.uplift.ai/api-reference/game-data/event-catalogue/segments/phase-of-play)
* [Dead Ball](https://docs.uplift.ai/api-reference/game-data/event-catalogue/segments/dead-ball)


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