Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

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_date

sport_event_context - stage

Date

End date of a sport event's stage
ex. 2024-10-01

order

sport_event_context - stage

Integer

Order of a stage within a season

phase

sport_event_context - stage

String

Name 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_date

sport_event_context - stage

Date

Start date of a sport event's stage
ex. 2024-03-20

type

sport_event_context - stage

String

Type of a sport event's stage
cup, league

year

sport_event_context - stage

String

Year 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_score

sport_event_status

Integer

Total score for the away team in the game

away_normaltime_score

sport_event_status

Integer

Score for the away team in normal time (9 innings)

home_score

sport_event_status

Integer

Total score for the home team in the game

home_normaltime_score

sport_event_status

Integer

Score for the home team in normal time (9 innings)

decided_inning

sport_event_status

Integer

Final inning number of a game

match_status

sport_event_status

String

Status 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_abandoned

sport_event_status

Boolean

Signifies a game was abandoned by a scout when true

status

sport_event_status

String

Status of a sport event
ex. not_started, live, ended, closed

See our FAQ for a complete list of statuses and their definitions.

winner_id

sport_event_status

String

Unique 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_namevenue StringCity 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
Credentials
Header
Click Try It! to start a request and see the response here!