Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Probabilities

Pesapallo Season Probabilities provides 3-way match win probabilities (home team win, away team win, draw) for all matches for a given season.

<Callout icon="⏱️" theme="default">
  ### Update Frequency

  60s Time To Live / Cache
</Callout>

> 📘 Pagination Note
>
> Pagination may be required to pull all data within this feed. By default, the feed will return 200 sport events.

***

<br />

<html>
<head>
<style>
.smallfont a {
  font-size: 95%
}
div.smallfont {
  font-size: 82%;
}
</style>
</head>

<body>

## Data Points

<details>
<summary><b><u>Match Probabilities:</u></b></summary>

<div class="smallfont">

| Attribute     | Parent Element       | Type   | Description                                                                               |
| ------------- | -------------------- | ------ | ----------------------------------------------------------------------------------------- |
| `name`        | `market`             | String | Probability market <br>`3way`                                                             |
| `name`        | `market` - `outcome` | String | Probability market outcome<br>`home_team_winner`, `away_team_winner`, `draw`              |
| `probability` | `market` - `outcome` | Float  | Probability of the market outcome (home win, away win, draw) in percentage<br> ex. `36.1` |

</div>
</details>

<details>
<summary><b><u>Category & Sport:</u></b></summary>

<div class="smallfont">

| Attribute      | Parent Element                     | Type   | Description                                                             |
| -------------- | ---------------------------------- | ------ | ----------------------------------------------------------------------- |
| `country_code` | `sport_event_context` - `category` | String | Country code for a sport event's category<br>ex. `FIN`                  |
| `id`           | `sport_event_context` - `category` | String | Unique category ID for a sport event<br>ex. `sr:category:597` (Finland) |
| `name`         | `sport_event_context` - `category` | String | Name for a sport event's category<br>ex. `Finland`                      |
| `id`           | `sport_event_context` - `sport`    | String | Unique sport ID for a sport event<br>ex. `sr:sport:61`                  |
| `name`         | `sport_event_context` - `sport`    | String | Name for a sport event's sport<br>ex. `Pesapallo`                       |

</div>
</details>

<details>
<summary><b><u>Competition:</u></b></summary>

<div class="smallfont">

| Attribute   | Parent Element                        | Type   | Description                                                          |
| ----------- | ------------------------------------- | ------ | -------------------------------------------------------------------- |
| `gender`    | `sport_event_context` - `competition` | String | Gender for a competition<br>ex. `men`, `women`                       |
| `id`        | `sport_event_context` - `competition` | String | Unique ID for a competition<br>ex. `sr:competition:783` (Superpesis) |
| `name`      | `sport_event_context` - `competition` | String | Name of a competition<br>ex. `Superpesis`                            |
| `parent_id` | `sport_event_context` - `competition` | String | Unique parent ID for a competition                                   |

</div>
</details>

<details>
<summary><b><u>Groups:</u></b></summary>

<div class="smallfont">

| Attribute    | Parent Element                             | Type   | Description                                                                            |
| ------------ | ------------------------------------------ | ------ | -------------------------------------------------------------------------------------- |
| `id`         | `sport_event_context` - `groups` - `group` | String | Unique ID for a sport event's group<br>ex. `sr:cup:159599` (Superpesis 2024, Playoffs) |
| `name`       | `sport_event_context` - `groups` - `group` | String | Name of a sport event's group<br>ex. `Superpesis 2024, Playoffs`                       |
| `group_name` | `sport_event_context` - `groups` - `group` | String | Abbreviated name of a sport event's group                                              |

</div>
</details>

<details>
<summary><b><u>Rounds:</u></b></summary>

<div class="smallfont">

| Attribute                          | Parent Element                  | Type    | Description                                                                                   |
| ---------------------------------- | ------------------------------- | ------- | --------------------------------------------------------------------------------------------- |
| `competition_sport_event_number`   | `sport_event_context` - `round` | Integer | Sport event number within a competition. Used for competitions that have fixed match numbers. |
| `cup_round_id`                     | `sport_event_context` - `round` | String  | Unique ID for a sport event's cup round<br>ex. `sr:cup_round:2045639`                         |
| `cup_round_number_of_sport_events` | `sport_event_context` - `round` | Integer | Number of events in a sport event's round                                                     |
| `cup_round_sport_event_number`     | `sport_event_context` - `round` | Integer | Number within the `cup_round` of a match ID. For example, 1st leg of 2                        |
| `name`                             | `sport_event_context` - `round` | String  | Name of a match's round<br>ex. `round_1` or `final`                                           |
| `number`                           | `sport_event_context` - `round` | Integer | Number of a match's round                                                                     |
| `other_sport_event_id`             | `sport_event_context` - `round` | String  | A linked sport event ID, typically in a two-legged tie<br>ex. `sr:sport_event:47395897`       |

</div>
</details>

<details>
<summary><b><u>Season:</u></b></summary>

<div class="smallfont">

| Attribute        | Parent Element                   | Type    | Description                                                                                |
| ---------------- | -------------------------------- | ------- | ------------------------------------------------------------------------------------------ |
| `competition_id` | `sport_event_context` - `season` | String  | Unique ID for the competition a season belongs to<br>ex. `sr:competition:783` (Superpesis) |
| `disabled`       | `sport_event_context` - `season` | Boolean | Signifies a season has been disabled when `true`                                           |
| `end_date`       | `sport_event_context` - `season` | Date    | End date of a season<br>ex. `2025-07-13`                                                   |
| `id`             | `season`                         | String  | Unique ID for a season<br>ex. `sr:season:114601` (Superpesis 2024)                         |
| `name`           | `sport_event_context` - `season` | String  | Name of a season<br>ex. `Superpesis 2024`                                                  |
| `start_date`     | `sport_event_context` - `season` | Date    | Start date of a season<br>ex. `2025-06-23`                                                 |
| `year`           | `sport_event_context` - `season` | String  | Year of a season<br>ex. `24/25` or `2024`                                                  |

</div>
</details>

<details>
<summary><b><u>Stages:</u></b></summary>

<div class="smallfont">

<Table>
  <thead>
    <tr>
      <th>
        Attribute
      </th>

      <th>
        Parent Element
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `end_date`
      </td>

      <td>
        `sport_event_context` - `stage`
      </td>

      <td>
        Date
      </td>

      <td>
        End date of a sport event's stage<br>ex. `2024-07-14`
      </td>
    </tr>

    <tr>
      <td>
        `order`
      </td>

      <td>
        `sport_event_context` - `stage`
      </td>

      <td>
        Integer
      </td>

      <td>
        Order of a stage within a season
      </td>
    </tr>

    <tr>
      <td>
        `phase`
      </td>

      <td>
        Name of a sport event's stage<br>ex. `playoffs`, `regular season`<br><br>See the <b>enum_phase</b> entry in our [Pesapallo OpenAPI](https://api.sportradar.com/pesapallo/trial/v2/openapi/swagger/index.html) spec for a complete list of valid `phase` enum values
      </td>

      <td>

      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        `start_date`
      </td>

      <td>
        `sport_event_context` - `stage`
      </td>

      <td>
        Date
      </td>

      <td>
        Start date of a sport event's stage<br>ex. `2024-06-24`
      </td>
    </tr>

    <tr>
      <td>
        `type`
      </td>

      <td>
        `sport_event_context` - `stage`
      </td>

      <td>
        String
      </td>

      <td>
        Type of a match's stage<br>`cup`, `league`
      </td>
    </tr>

    <tr>
      <td>
        `year`
      </td>

      <td>
        `sport_event_context` - `stage`
      </td>

      <td>
        String
      </td>

      <td>
        Year of a match's stage<br>ex. `23/24` or `2024`
      </td>
    </tr>
  </tbody>
</Table>

</div>
</details>

<details>
<summary><b><u>Competitor:</u></b></summary>

<div class="smallfont">

| Attribute      | Parent Element               | Type    | Description                                                                                               |
| -------------- | ---------------------------- | ------- | --------------------------------------------------------------------------------------------------------- |
| `abbreviation` | `competitors` - `competitor` | String  | Abbreviation for a competitor name<br>ex. `HYV`                                                           |
| `age_group`    | `competitors` - `competitor` | String  | Age group of a competitor, when applicable<br>ex. `U23`                                                   |
| `country`      | `competitors` - `competitor` | String  | Country of a competitor<br>ex. `Finland`                                                                  |
| `country_code` | `competitors` - `competitor` | String  | Country code of a competitor<br>ex. `FIN`                                                                 |
| `gender`       | `competitors` - `competitor` | String  | Gender of a competitor<br>ex. `male`                                                                      |
| `id`           | `competitors` - `competitor` | String  | Unique ID for a competitor<br>ex. `sr:competitor:41831`                                                   |
| `name`         | `competitors` - `competitor` | String  | Name for a competitor<br>ex. `Hyvinkaan Tahko`                                                            |
| `qualifier`    | `competitors` - `competitor` | String  | Designation of a competitor for a match<br>`home`, `away`                                                 |
| `virtual`      | `competitors` - `competitor` | Boolean | Signifies a competitor is virtual when `true`. Used for placeholder players/teams in TBD vs TBD matchups. |

</div>
</details>

<details>
<summary><b><u>Coverage Properties:</u></b></summary>

<div class="smallfont">

| Attribute | Parent Element             | Type   | Description                                         |
| --------- | -------------------------- | ------ | --------------------------------------------------- |
| `live`    | `sport_event` - `coverage` | String | Signifies a sport event is covered live when `true` |

</div>
</details>

<details>
<summary><b><u>Sport Event:</u></b></summary>

<div class="smallfont">

| Attribute              | Parent Element | Type    | Description                                                                                                             |
| ---------------------- | -------------- | ------- | ----------------------------------------------------------------------------------------------------------------------- |
| `id`                   | `sport_event`  | String  | Unique ID of a match<br>ex. `sr:sport_event:52487135`                                                                   |
| `replaced_by`          | `sport_event`  | String  | An alternative sport event ID if the match is postponed and played at a later date<br>ex. `sr:sport_event:51847153`     |
| `resume_time`          | `sport_event`  | Date    | An updated timestamp if there is a delay at the start or interruption during a match<br>ex. `2024-03-26T20:00:00+00:00` |
| `start_time`           | `sport_event`  | Date    | Start time of a match<br>ex. `2024-03-26T20:00:00+00:00`                                                                |
| `start_time_confirmed` | `sport_event`  | Boolean | Signifies the start time of a match is confirmed when `true`                                                            |

</div>
</details>

<details>
<summary><b><u>Venue:</u></b></summary>

<div class="smallfont">

| Attribute              | Parent Element | Type    | Description                                                                 |
| ---------------------- | -------------- | ------- | --------------------------------------------------------------------------- |
| `capacity`             | `venue`        | Integer | Capacity of a venue<br>ex. `4000`                                           |
| `city_name`            | `venue`        | String  | City name of a venue<br>ex. `Hyvinkaa`                                      |
| `country_code`         | `venue`        | String  | Country code of a venue<br>ex. `FIN` (Finland)                              |
| `country_name`         | `venue`        | String  | Country name of a venue<br>ex. `Finland`                                    |
| `id`                   | `venue`        | String  | Unique ID of a venue<br>ex. `sr:venue:8365`                                 |
| `map_coordinates`      | `venue`        | String  | Coordinates of a venue<br>ex. `60.639388,24.865846`                         |
| `name`                 | `venue`        | String  | Name of a venue<br>ex. `Pihkalan pesäpallostadion`                          |
| `reduced_capacity`     | `venue`        | Boolean | Optional attribute signifying a venue has a restricted capacity when `true` |
| `reduced_capacity_max` | `venue`        | Integer | Value of a venue's restricted capacity                                      |
| `timezone`             | `venue`        | String  | Timezone of a venue<br>ex. `Europe/Helsinki`                                |

</div>
</details>

</body>
</html>
Language
Credentials
Header
Click Try It! to start a request and see the response here!