Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Info

Pesapallo Season Info provides detailed information for a given season, including participating competitors and league structure.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

300s Time To Live / Cache


Data Points

<Accordion title="Category & Sport" icon="fa-light fa-baseball">

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

</Accordion>

<Accordion title="Competition" icon="fa-light fa-baseball">

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

</Accordion>

<Accordion title="Groups" icon="fa-light fa-baseball">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `stage` - `groups` - `group` | String | Unique ID for a stage or season's group<br /><br />ex. `sr:league:81059` (Superpesis 2024) or `sr:cup:151361` (Superpesis 2024, Playoffs) |
| `max_rounds` | `stage` - `groups` - `group` | Integer | Maximum number of rounds for a stage or season |
| `name` | `stage` - `groups` - `group` | String | Name of a stage or season's group<br /><br />ex. `Superpesis 2024` or `Superpesis 2024, Playoffs` |
| `group_name` | `stage` - `groups` - `group` | String | Abbreviated name of a stage or season's group<br /><br />ex. `Relegation/Promotion` |

</Accordion>

<Accordion title="Season" icon="fa-light fa-baseball">

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

</Accordion>

<Accordion title="Stages" icon="fa-light fa-baseball">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `end_date` | `stage` | Date | End date of a season or stage<br><br>ex. `2024-07-14` |
| `order` | `stage` | Integer | Order of a stage within a season |
| `phase` | `stage` | String | Name of a season or stage<br><br>ex. `playoffs`, `regular season`<br><br>See the enum_phase 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 |
| `start_date` | `stage` | Date | Start date of a season or stage<br><br>ex. `2024-06-24` |
| `type` | `stage` | String | Type of a season or stage<br><br>`cup`, `league` |
| `year` | `stage` | String | Year of a season or stage<br><br>ex. `23/24` or `2024` |

</Accordion>

<Accordion title="Competitor" icon="fa-light fa-baseball">

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

</Accordion>

Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
required
Defaults to en

2-letter code for supported languages

en (English)

English is the only fully supported language for this API. Click here for valid language codes and a tabular list of available languages per competition.

string
required
Defaults to sr:season:128327

Unique Id of a season, found in the Seasons endpoint

Note: The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.

Example: sr:season:114601

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json