Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Competitor Summaries

Global Football 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. CAN (Canada)
idsport_event_context - categoryStringUnique category ID for a sport event
ex. sr:category:93
namesport_event_context - categoryStringName for a sport event's category
ex. Canada
idsport_event_context - sportStringUnique sport ID for a sport event
sr:sport:16
namesport_event_context - sportStringName for a sport event's sport
American Football
Competition:
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition
men, women
idsport_event_context - competitionStringUnique ID for a competition
ex. sr:competition:790 (CFL)
namesport_event_context - competitionStringName of a competition
ex. CFL, NFL, NCAA
parent_idsport_event_context - competitionStringUnique parent ID for a competition. Typically present for group competitions
ex. sr:competition:850 used to group NCAA postseason tournaments.
Groups:
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group
ex. sr:league:83021 (NFL 24/25, NFC North)
namesport_event_context - groups - groupStringName of a sport event's group
ex. NFL 24/25, NFL 24/25, NFC, NFL 24/25, NFC North
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
ex. NFC North
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:1751367
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. american_football_conference_championship or super_bowl
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 sport event belongs to
ex. sr:competition:31 (NFL)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a sport event's season
ex. 2024-02-11
idsport_event_context - seasonStringUnique ID for a sport event's season
ex. sr:season:108577 (NFL 23/24)
namesport_event_context - seasonStringName of a sport event's season
ex. NFL 23/24
start_datesport_event_context - seasonDateStart date of a sport event's season
ex. 2023-09-07
yearsport_event_context - seasonStringYear of a sport event's season
ex. 23/24
Stages:

Attribute

Parent Element

Type

Description

end_date

sport_event_context - stage

Date

End date of a sport event's stage
ex. 2024-02-11

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 American Football 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-01-13

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

Competitor:
AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name
ex. DEN (Denver Broncos)
age_groupcompetitors - competitorStringAge group of a competitor, when applicable
ex. U23
countrycompetitors - competitorStringCountry of a competitor
ex. USA
country_codecompetitors - competitorStringCountry code of a competitor
ex. USA (United States))
divisioncompetitors - competitorIntegerDivision number for a competitor
gendercompetitors - competitorStringGender for a competitor
male, female
idcompetitors - competitor`StringUnique ID for a competitor
ex. sr:competitor:4418 (Denver Broncos)
namecompetitors - competitorStringName for a competitor
ex. Denver Broncos
qualifiercompetitors - competitorStringDesignation of a competitor for a sport event
home, away
statecompetitors - competitorStringState of a competitor
ex. CO (Colorado)
virtualcompetitors - competitorBooleanSignifies a competitor is a virtual team whan true. Used for placeholder teams in TBD vs TBD matchups.
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:46791659
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date
ex. sr:sport_event:46791659
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
Sport Event - Coverage Properties:
AttributeParent ElementTypeDescription
livesport_event - coverageBooleanSignifies a sport event is covered live when true
Period Scores:
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway team period score
home_scoresport_event_status - period_scores - period_scoreIntegerHome team period score
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod type
regular_period, overtime, 1st_quarter, 2nd_quarter, 3rd_quarter, 4th_quarter, 1st_pause, 2nd_pause, 3rd_pause, awaiting_overtime, interrupted
Sport Event Status:

Attribute

Parent Element

Type

Description

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

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

match_status

sport_event_status

String

Status within a match (sport event). Provides more detail on the state of a sport event when live than status
ex. not_started, 1st_quarter, ended, cancelled

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

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 match winner
ex. sr:competitor:44

Venue:
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue
ex. 76125
changedvenueBooleanSignifies a venue has been changed when true
city_namevenueStringCity name of a venue
ex. Denver
country_codevenueStringCountry code of a venue
ex. USA (United States)
country_namevenueStringCountry name of a venue
ex. USA
idvenueStringUnique ID of a venue
ex. sr:venue:8179
map_coordinatesvenueStringCoordinates of a venue
ex. 39.743865,-105.020158
namevenueStringName of a venue
ex. Empower Field at Mile High
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/Denver
Language
Credentials
Header
Click Try It! to start a request and see the response here!