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>
⏱️

Update Frequency

60s Time To Live / Cache

📘

Pagination Note

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


Data Points

Match Probabilities
AttributeParent ElementTypeDescription
namemarketStringProbability market

3way
namemarket - outcomeStringProbability market outcome

home_team_winner, away_team_winner, draw
probabilitymarket - outcomeFloatProbability of the market outcome (home win, away win, draw) in percentage

ex. 36.1
Category & Sport
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a sport event's category

ex. FIN
idsport_event_context - categoryStringUnique category ID for a sport event

ex. sr:category:597 (Finland)
namesport_event_context - categoryStringName for a sport event's category

ex. Finland
idsport_event_context - sportStringUnique sport ID for a sport event

ex. sr:sport:61
namesport_event_context - sportStringName for a sport event's sport

ex. Pesapallo
Competition
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition

ex. men, women
idsport_event_context - competitionStringUnique ID for a competition

ex. sr:competition:783 (Superpesis)
namesport_event_context - competitionStringName of a competition

ex. Superpesis
parent_idsport_event_context - competitionStringUnique parent ID for a competition
Groups
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group

ex. sr:cup:159599 (Superpesis 2024, Playoffs)
namesport_event_context - groups - groupStringName of a sport event's group

ex. Superpesis 2024, Playoffs
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
Rounds
AttributeParent ElementTypeDescription
competition_sport_event_numbersport_event_context - roundIntegerSport event number within a competition. Used for competitions that have fixed match numbers.
cup_round_idsport_event_context - roundStringUnique ID for a sport event's cup round

ex. sr:cup_round:2045639
cup_round_number_of_sport_eventssport_event_context - roundIntegerNumber of events in a sport event's round
cup_round_sport_event_numbersport_event_context - roundIntegerNumber within the cup_round of a match ID. For example, 1st leg of 2
namesport_event_context - roundStringName of a match's round

ex. round_1 or final
numbersport_event_context - roundIntegerNumber of a match's round
other_sport_event_idsport_event_context - roundStringA linked sport event ID, typically in a two-legged tie

ex. sr:sport_event:47395897
Season
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a season belongs to

ex. sr:competition:783 (Superpesis)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a season

ex. 2025-07-13
idseasonStringUnique ID for a season

ex. sr:season:114601 (Superpesis 2024)
namesport_event_context - seasonStringName of a season

ex. Superpesis 2024
start_datesport_event_context - seasonDateStart date of a season

ex. 2025-06-23
yearsport_event_context - seasonStringYear of a season

ex. 24/25 or 2024
Stages
AttributeParent ElementTypeDescription
end_datesport_event_context - stageDateEnd date of a sport event's stage

ex. 2024-07-14
ordersport_event_context - stageIntegerOrder of a stage within a season
phaseName of a sport event's stage

ex. playoffs, regular season

See the enum_phase entry in our Pesapallo OpenAPI spec for a complete list of valid phase enum values
start_datesport_event_context - stageDateStart date of a sport event's stage

ex. 2024-06-24
typesport_event_context - stageStringType of a match's stage

cup, league
yearsport_event_context - stageStringYear of a match's stage

ex. 23/24 or 2024
Competitor
AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name

ex. HYV
age_groupcompetitors - competitorStringAge group of a competitor, when applicable

ex. U23
countrycompetitors - competitorStringCountry of a competitor

ex. Finland
country_codecompetitors - competitorStringCountry code of a competitor

ex. FIN
gendercompetitors - competitorStringGender of a competitor

ex. male
idcompetitors - competitorStringUnique ID for a competitor

ex. sr:competitor:41831
namecompetitors - competitorStringName for a competitor

ex. Hyvinkaan Tahko
qualifiercompetitors - competitorStringDesignation of a competitor for a match

home, away
virtualcompetitors - competitorBooleanSignifies a competitor is virtual when true. Used for placeholder players/teams in TBD vs TBD matchups.
Coverage Properties
AttributeParent ElementTypeDescription
livesport_event - coverageStringSignifies a sport event is covered live when true
Sport Event
AttributeParent ElementTypeDescription
idsport_eventStringUnique ID of a match

ex. sr:sport_event:52487135
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date

ex. sr:sport_event:51847153
resume_timesport_eventDateAn updated timestamp if there is a delay at the start or interruption during a match

ex. 2024-03-26T20:00:00+00:00
start_timesport_eventDateStart time of a match

ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a match is confirmed when true
Venue
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue

ex. 4000
city_namevenueStringCity name of a venue

ex. Hyvinkaa
country_codevenueStringCountry code of a venue

ex. FIN (Finland)
country_namevenueStringCountry name of a venue

ex. Finland
idvenueStringUnique ID of a venue

ex. sr:venue:8365
map_coordinatesvenueStringCoordinates of a venue

ex. 60.639388,24.865846
namevenueStringName of a venue

ex. Pihkalan pesäpallostadion
reduced_capacityvenueBooleanOptional attribute signifying a venue has a restricted capacity when true
reduced_capacity_maxvenueIntegerValue of a venue's restricted capacity
timezonevenueStringTimezone of a venue

ex. Europe/Helsinki
Language
Credentials
Header
Click Try It! to start a request and see the response here!