Docs
Coverage MatrixDocumentationRelease LogLog InContact Us

Live Summaries

Global Baseball Live Summaries provides game information for all currently live games, including team scoring. This feed updates in real time as games are played.

⏱️

Update Frequency

1s Time To Live / Cache



Data Points

Category & Sport:
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a competition category
ex. JPN (Japan)
idsport_event_context - categoryStringUnique category ID for a competition
ex. sr:category:211
namesport_event_context - categoryStringName for a competition category
ex. Japan
idcompetitor_profile - sportStringUnique sport ID for a competitor
ex. sr:sport:3
namecompetitor_profile - sportStringName for a competitor's sport
ex. Baseball
Competition:
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition
men, women
idsport_event_context - competitionStringUnique ID for a competition
ex. sr:competition:1036 (NPB)
namesport_event_context - competitionStringName of a competition
ex. NPB, Italian Baseball League
parent_idsport_event_context - competitionStringUnique parent ID for a competition. Typically present for group competitions
ex. sr:competition:37221 used to group NCAA tournaments.
Groups:
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group
ex. sr:league:80925 (National League West)
namesport_event_context - groups - groupStringName of a sport event's group
ex. MLB 2024, National League West
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
ex. National League West
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:1988995
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:1036 (NPB 2024)
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:99979 (World Baseball Classic 2023)
namesport_event_context - seasonStringName of a season
ex. NPB 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, conference, playoffs

See the enum_phase entry in our Global Baseball 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
abbreviationcompetitorStringAbbreviation for a competitor name
ex. LAD (Los Angeles Dodgers)
age_groupcompetitorStringAge group of a competitor, when applicable
ex. U23
countrycompetitorStringCountry of a competitor
ex. Japan
country_codecompetitorStringCountry code of a competitor
ex. JPN (Japan)
gendercompetitorStringGender for a competitor
male, female
idcompetitorStringUnique ID for a competitor
ex. sr:competitor:3638 (Los Angeles Dodgers)
namecompetitorStringName for a competitor
ex. Los Angeles Dodgers
qualifiercompetitors - competitorStringDesignation of a competitor for a sport event
home, away
virtualcompetitorBooleanSignifies a competitor is a virtual team whan true. Used for placeholder teams in TBD vs TBD matchups.
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 of a sport event is available when true
scoressport_event - coverage - sport_event_propertiesStringsIndicates when sport event scores are made available
live, post (Postgame)
Sport Event:
AttributeParent ElementTypeDescription
idsport_eventStringUnique ID of a sport event
ex. sr:sport_event:49796317
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date
ex. sr:sport_event:47395897
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_scoreIntegerInning number
typesport_event_status - period_scores - period_scoreStringInning type
started, overtime, overtime_break, break, interrupted, 1st_inning, 2nd_inning, 3rd_inning, 4th_inning, 5th_inning, 6th_inning, 7th_inning, 8th_inning, 9th_inning, regular_period
Sport Event Status:
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away team in the game
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time (9 innings)
home_scoresport_event_statusIntegerTotal score for the home team in the game
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time (9 innings)
decided_inningsport_event_statusIntegerFinal inning number of a game
match_statussport_event_statusStringStatus within a game (sport event). Provides more detail on the state of a sport event when live than status
ex. not_started, start_delayed, 1st_inning, postponed

See our FAQ for a complete list of statuses and their definitions.
scount_abandonedsport_event_statusBooleanSignifies a game was abandoned by a scout when true
statussport_event_statusStringStatus of a sport event
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 game winner
ex. sr:competitor:3638
Venue:
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a competitor's home venue
ex. 56000
changedvenueBooleanSignifies a venue has been changed when true
city_namevenueStringCity name of a competitor's home venue
ex. Los Angeles
country_codevenueStringCountry code of a competitor's home venue
ex. USA
country_namevenueStringCountry name of a competitor's home venue
ex. USA
idvenueStringUnique ID of a competitor's home venue
ex. sr:venue:8117
map_coordinatesvenueStringCoordinates of a competitor's home venue
ex. 34.0745409,-118.2408881
namevenueStringName of a competitor's home venue
ex. Dodger Stadium
reduced_capacityvenueBooleanOptional attribute signifying a venue has a restricted capacity when true
reduced_capacity_maxvenueIntegerValue of a venue's restrictued capacity
timezonevenueStringTimezone of a competitor's home venue
ex. America/Los_Angeles
Language
Authorization
Query
Click Try It! to start a request and see the response here!