> ## 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">
    5 possible statuses
  </Card>

  <Card title="Matches" icon="table-tennis-paddle-ball">
    8 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 or postponed. See the [Data Synchronization](/docs/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 |
| `postponed` | Tournament was postponed; dates are the last announced |

***

## Match Statuses

Matches progress through the following statuses. See the [Data Synchronization](/docs/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) |
| `not_played` | Both pairs were known and the match never took place, with no winner awarded |

<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, bye and not_played?">
    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, and has a winner. A `bye` means no match took place because there was no opponent to play. A `not_played` match had both pairs on the sheet and never took place, so there is no winner.
  </Accordion>

  <Accordion title="Which statuses are permanent?">
    Some match statuses are permanent once set and will never change: `finished`, `retired` and `walkover`. Others are variable and will change as the match progresses: `scheduled`, `live`, and `ended`. `bye` and `not_played` are stable in practice, but they describe a match that was not played rather than a result, so they yield if a result is later recorded for that match.
  </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. Note that `full` guarantees game-level completeness; individual points within a game may occasionally be missing.
</Tip>


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