Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Summaries

Global Baseball Season Summaries provides schedule information and scoring for all matches from a given season.

⏱️

Update Frequency

300s Time To Live / Cache

📘

Pagination Note

Pagination will often be required to pull all data within this feed. By default, the feed will return 200 sport events.



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
idsport_event_context - sportStringUnique sport ID for a competitor
ex. sr:sport:3
namesport_event_context - 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
neutralsport_event_conditions - groundBooleanSignifies a neutral ground sport event when true
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!