Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Competitor Summaries

Pesapallo Competitor Summaries provides scheduling information for upcoming matches and results for the 30 most recent completed matches of a specified competitor.

⏱️

Update Frequency

300s Time To Live / Cache


Data Points

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
Sport Event Status
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away competitor in a match
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time
home_scoresport_event_statusIntegerTotal score for the home competitor in a match
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time
match_statussport_event_statusStringStatus within a match (sport event). Provides more detail on the state of a match when live than status

ex. not_started, 1st_period, aet, ended

See our FAQ for a complete list of statuses and their definitions.
scount_abandonedsport_event_statusBooleanSignifies a match was abandoned by a scout when true
statussport_event_statusStringStatus of a sport event

ex. not_started, ended, closed

See our FAQ for a complete list of statuses and their definitions.
winner_idsport_event_statusStringUnique ID of the match winner

ex. sr:competitor:41839
Period Scores
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway competitor period score
home_scoresport_event_status - period_scores - period_scoreIntegerHome competitor period score
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod type

ex. regular_period, overtime
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!