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

# Statuses

> Reference for all possible status values for seasons, tournaments and matches in the Padel API.

Resources in the Padel API include a `status` field that reflects their current state. This page describes all possible values for seasons, tournaments, matches, and point-by-point coverage.

<CardGroup cols={3}>
  <Card title="Seasons" icon="calendar">
    3 possible statuses
  </Card>

  <Card title="Tournaments" icon="trophy">
    4 possible statuses
  </Card>

  <Card title="Matches" icon="table-tennis-paddle-ball">
    7 possible statuses
  </Card>
</CardGroup>

***

## Season Statuses

Indicates whether a season is yet to start, currently active, or complete.

| Status     | Description                     |
| ---------- | ------------------------------- |
| `upcoming` | Season has not started yet      |
| `active`   | Season is currently in progress |
| `finished` | Season has concluded            |

***

## Tournament Statuses

Tournaments progress from `pending` through `finished`, unless cancelled. See the [Data Synchronization](/guides/data-synchronization#tournaments) guide for best practices on keeping your data up to date.

| Status      | Description                                     |
| ----------- | ----------------------------------------------- |
| `pending`   | Tournament is scheduled but has not started yet |
| `live`      | Tournament is currently in progress             |
| `finished`  | Tournament has concluded                        |
| `cancelled` | Tournament was cancelled                        |

***

## Match Statuses

Matches progress through the following statuses. See the [Data Synchronization](/guides/data-synchronization#matches) guide for best practices on keeping your data up to date.

**`scheduled`** → **`finished`** (without live coverage)

**`scheduled`** → **`live`** → **`ended`** → **`finished`** (with live coverage)

| Status             | Description                                                       |
| ------------------ | ----------------------------------------------------------------- |
| `scheduled`        | Match has not started yet                                         |
| `live`             | Match is in progress with real-time point-by-point data available |
| `ended`            | Match has ended but the score is not yet confirmed                |
| `finished`         | Match completed with confirmed score                              |
| **Other statuses** |                                                                   |
| `retired`          | Match ended early due to a player retirement                      |
| `walkover`         | Match awarded without play                                        |
| `bye`              | Match was not played (no opponent)                                |

<AccordionGroup>
  <Accordion title="What is the difference between ended and finished?">
    Both statuses mean the match is over, but `ended` is a transitional state where the match has concluded on court but the score has not yet been confirmed. It will automatically transition to `finished` within a few minutes once the result is processed. Note that `ended` only appears on matches with live tracking — matches without live coverage transition directly from `scheduled` to `finished`.
  </Accordion>

  <Accordion title="What is the difference between retired, walkover and bye?">
    A `retired` match started and has a partial score — one team couldn't continue. A `walkover` was awarded before play began, typically due to an injury or withdrawal. A `bye` means no match took place because there was no opponent to play.
  </Accordion>

  <Accordion title="Which statuses are permanent?">
    Some match statuses are permanent once set and will never change: `finished`, `retired`, `walkover`, and `bye`. Others are variable and will change as the match progresses: `scheduled`, `live`, and `ended`.
  </Accordion>
</AccordionGroup>

***

## Point-by-Point Coverage

Matches with point-by-point data include a `coverage` field available in the `/live` endpoint, indicating how complete the tracking is.

| Coverage   | Description                                              |
| ---------- | -------------------------------------------------------- |
| `tracking` | Match is live — coverage will be determined once it ends |
| `full`     | All games are tracked and match the confirmed score      |
| `partial`  | Some games are missing due to gaps in the live feed      |
| `null`     | No point-by-point data available for this match          |

<Tip>
  Use `coverage: "full"` matches for statistical analysis that requires complete point-level data.
</Tip>