Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Provides top-level information for live games. If probabilities are available for a game, pre-match and live probabilities will be displayed.

⏱️

Update Frequency

1s Time To Live / Cache



Data Points

Category & Sport:
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a sport event's category
ex. DEU (Germany)
idsport_event_context - categoryStringUnique category ID for a sport event
ex. sr:category:53
namesport_event_context - categoryStringName for a sport event's category
ex. Germany
idsport_event_context - sportStringUnique sport ID for a sport event
ex. sr:sport:6
namesport_event_context - sportStringName for a sport event's sport
ex. Handball
Competition:
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition
men, women
idsport_event_context - competitionStringUnique ID for a competition
ex. sr:competition:161 (Handbollsligan)
namesport_event_context - competitionStringName of a competition
ex. Handbollsligan
parent_idsport_event_context - competitionStringUnique parent ID for a competition. Typically present for group stage or playoff competitions
ex. sr:competition:945 used to link competitions together, like the World Cup and the various qualifiers.
Coverage Properties:
AttributeParent ElementTypeDescription
typesport_event - coverageStringType of coverage for a sport event
sport_event, competition
basic_play_by_playsport_event - coverage - sport_event_propertiesBooleanSignifies basic play-by-play is available for a group when true
basic_player_statssport_event - coverage - sport_event_propertiesBooleanSignifies basic player stats is available for a group when true
basic_team_statssport_event - coverage - sport_event_propertiesBooleanSignifies basic team stats is available for a group when true
goal_scorerssport_event - coverage - sport_event_propertiesBooleanSignifies goal scorers are available for a group when true
lineupssport_event - coverage - sport_event_propertiesBooleanSignifies goal lineups are available for a group when true
scoressport_event - coverage - sport_event_propertiesStringDescribes the availability of scores as live or post-match
live, post
Groups:
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group
ex. sr:league:83057 (Olympic Tournament 2024, Group A)
namesport_event_context - groups - groupStringName of a sport event's group
ex. Olympic Tournament 2024, Group A
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
ex. A
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:2029419
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 sport event's round
ex. quarterfinal or final
numbersport_event_context - roundIntegerNumber of a sport event's round
other_sport_event_idsport_event_context - roundStringA linked sport event ID, typically in a two-legged tie
ex. sr:sport_event:47395897
Seasons:
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a season belongs to
ex. sr:competition:160 (EHF Euro)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a season
ex. 2024-11-03
idsport_event_context - seasonStringUnique ID for a season
ex. sr:season:105127 (EHF Euro 2024)
namesport_event_context - seasonStringName of a season
ex. EHF Euro 2024
start_datesport_event_context - seasonDateStart date of a season
ex. 2024-03-29
yearsport_event_context - seasonStringYear of a season
ex. 23/24 or 2024
Stages:
AttributeParent ElementTypeDescription
end_datesport_event_context - stageDateEnd date of a sport event's stage
ex. 2024-10-01
ordersport_event_context - stageIntegerOrder of a stage within a season
phasesport_event_context - stageStringName of a sport event's stage
ex. regular season, qualification, playoffs

See the enum_phase entry in our Handball 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-03-20
typesport_event_context - stageStringType of a sport event's stage
cup, league
yearsport_event_context - stageStringYear of a sport event's stage
ex. 23/24 or 2024
Competitor:
AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name
ex. RNL (Rhein-Neckar Lowen)
age_groupcompetitors - competitorStringAge group of a competitor, when applicable
ex. U23
countrycompetitors - competitorStringCountry of a competitor
ex. Germany
country_codecompetitors - competitorStringCountry code of a competitor
ex. DEU (Germany)
gendercompetitors - competitorStringGender for a competitor
male, female
idcompetitors - competitorStringUnique ID for a competitor
ex. sr:competitor:4004 (Rhein-Neckar Lowen)
namecompetitors - competitorStringName for a competitor
ex. Rhein-Neckar Lowen
qualifiercompetitors - competitorStringDesignation of a competitor for a season
home, away
virtualcompetitors - competitorBooleanSignifies a competitor is a virtual team whan true. Used for placeholder teams in TBD vs TBD matchups.
Match Probabilities:
AttributeParent ElementTypeDescription
away_scoremarketIntegerScore for the away team
home_scoremarketIntegerScore for the home team
last_updatedmarketDate-timeTimestamp of the most recent probability update
ex. 2024-04-23T19:22:59+00:00
livemarketBooleanSignifies that the match is live for this market when true
match_timemarketStringClock value of a match in minutes and seconds
ex. 22:50
namemarketStringProbability market (2-way, 3-way, or to qualify)
2way, 3way to_qualify
remaining_timemarketStringRemaining time in a match

Not currently in use
remaining_time_in_periodmarketStringRemaining time in a period

Not currently in use
removedmarketBooleanSignifies a market has been removed when true
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
Sport Event:
AttributeParent ElementTypeDescription
countsport_event_conditions - attendanceIntegerAttendance for a sport event
ex. 13203
neutralsport_event_conditions - groundBooleanSignifies a neutral ground sport event when true
idsport_eventStringUnique ID of a sport event
ex. sr:sport_event:41192363
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date
ex. sr:sport_event:41192363
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 sport event
ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a sport event is confirmed when true
Period Scores:
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway team inning score
home_scoresport_event_status - period_scores - period_scoreIntegerHome team inning score
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod type
regular_period, overtime, penalties, awaiting_penalties, 1st_half, 2nd_half, pause, 1st_extra, 2nd_extra, awaiting_extra, extra_time_halftime, interrupted
Referee:
AttributeParent ElementTypeDescription
idsport_event_conditions - referees - refereeStringUnique ID for a referee
ex. sr:referee:1289328
namesport_event_conditions - referees - refereeStringName of a referee
ex. Nachevski, Gjorgji
nationalitysport_event_conditions - referees - refereeStringNationality of a referee
ex. North Macedonia
country_codesport_event_conditions - referees - refereeStringCountry code of a referee
ex. MKD
typesport_event_conditions - referees - refereeStringType of a referee
ex. referee
Sport Event Status:
AttributeParent ElementTypeDescription
aggregate_away_scoresport_event_statusIntegerAggregate score (of multiple sport events) for the away team
aggregate_home_scoresport_event_statusIntegerAggregate score (of multiple sport events) for the home team
aggregate_winner_idsport_event_statusStringUnique ID of the aggregate score winner
ex. sr:competitor:44
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time
away_overtime_scoresport_event_statusIntegerScore for the away team in overtime
away_scoresport_event_statusIntegerTotal score for the away team in the match
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time
home_overtime_scoresport_event_statusIntegerScore for the home team in overtime
home_scoresport_event_statusIntegerTotal score for the home team in the match
decided_by_fedsport_event_statusBooleanSignifies a match result was decided by the federation when true. For example, incomplete due to crowd disruption
match_statussport_event_statusStringStatus within a match. Provides more detail on the state of a match when live than status
ex. not_started, 2nd_half, ended, awaiting_penalties

See our Handball OpenAPI under enum_sport_event_match_status for a complete list of statuses
match_tiesport_event_statusBooleanSignifies a match ended in a tie when true
scount_abandonedsport_event_statusBooleanSignifies a match was abandoned by a scout when true
statussport_event_statusStringStatus of a match
ex. not_started, live, 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:7578
Match Stats (Team):
AttributeParent ElementTypeDescription
assistscompetitor - statisticsIntegerTotal team assists for a match
blockscompetitor - statisticsIntegerTotal team blocks for a match
field_goalscompetitor - statisticsIntegerTotal team field goals for a match
goals_concededcompetitor - statisticsIntegerTotal team goals conceded for a match
goals_scoredcompetitor - statisticsIntegerTotal team goals scored for a match
red_cardscompetitor - statisticsIntegerTotal team red cards for a match
savescompetitor - statisticsIntegerTotal team saves for a match
seven_m_goalscompetitor - statisticsIntegerTotal team 7-meter throw goals for a match
shot_accuracycompetitor - statisticsFloatTeam shot accuracy percentage for a match
ex. 63.04
shotscompetitor - statisticsIntegerTotal team shots for a match
shots_againstcompetitor - statisticsIntegerTotal team shots against for a match
shots_off_goalcompetitor - statisticsIntegerTotal team shots off goal for a match
shots_on_goalcompetitor - statisticsIntegerTotal team shots on goal for a match
stealscompetitor - statisticsIntegerTotal team steals for a match
suspensionscompetitor - statisticsIntegerTotal team suspensions for a match
technical_foulscompetitor - statisticsIntegerTotal team technical fouls for a match
yellow_cardscompetitor - statisticsIntegerTotal team yellow cards for a match
Match Stats (Player):
AttributeParent ElementTypeDescription
assistsplayer - statisticsIntegerPlayer assists for a match
blocksplayer - statisticsIntegerPlayer blocks for a match
field_goalsplayer - statisticsIntegerPlayer field goals for a match
goalkeeper_minutes_playedplayer - statisticsStringNumber of minutes played for a goalkeeper in a match
ex. 34:03
goals_concededplayer - statisticsIntegerNumber of goals conceded for a goalkeeper in a match
goals_scoredplayer - statisticsIntegerPlayer goals scored for a match
red_cardsplayer - statisticsIntegerPlayer red cards for a match
save_accuracyplayer - statisticsFloatSave percentage for a goalkeeper in a match
ex. 34.78
savesplayer - statisticsIntegerNumber of saves for a goalkeeper in a match
seven_m_goalsplayer - statisticsIntegerPlayer 7-meter goals for a match
seven_m_savesplayer - statisticsIntegerPlayer 7-meter throw saves in a match
shot_accuracyplayer - statisticsFloatPlayer shot accuracy percentage for a match
ex. 63.04
shotsplayer - statisticsIntegerPlayer shots for a match
shots_againstplayer - statisticsIntegerNumber of shots against for a goalkeeper in a match
shots_off_goalplayer - statisticsIntegerPlayer shots off goal for a match
shots_on_goalplayer - statisticsIntegerPlayer shots on goal for a match
stealsplayer - statisticsIntegerPlayer steals for a match
suspensionsplayer - statisticsIntegerPlayer suspensions for a match
technical_foulsplayer - statisticsIntegerPlayer technical fouls for a match
yellow_cardsplayer - statisticsIntegerPlayer yellow cards for a match
Venue:
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue
ex. 13200
changedvenueBooleanSignifies a venue has been changed when true
city_namevenueStringCity name of a venue
ex. Mannheim
country_codevenueStringCountry code of a venue
ex. DEU
country_namevenueStringCountry name of a venue
ex. Germany
idvenueStringUnique ID of a venue
ex. sr:venue:2010
map_coordinatesvenueStringCoordinates of a venue
ex. 49.463730,8.517570
namevenueStringName of a venue
ex. SAP Arena
reduced_capacityvenueBooleanOptional attribute signifying a venue has a restricted capacity when true
reduced_capacity_maxvenueIntegerValue of a venue's restrictued capacity
timezonevenueStringTimezone of a venue
ex. Europe/Berlin
Language
Credentials
Query
Click Try It! to start a request and see the response here!