Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Returns a list of summaries for all competitions given a specific date: yyyy-mm-dd.

⏱️

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 sport event's category
idsport_event_context - categoryStringUnique category ID for a sport event
ex. sr:category:3 (ATP)
namesport_event_context - categoryStringName for a sport event's category
ex. ATP
idsport_event_context - sportStringUnique sport ID for a sport event
ex. sr:sport:5
namesport_event_context - sportStringName for a sport event's sport
ex. Tennis
Competition:
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition
men, women, mixed
idsport_event_context - competitionStringUnique ID for a competition
ex. sr:competition:2555 (Wimbledon Men Singles)
levelsport_event_context - competitionStringLevel of a competition
grand_slam, atp_1000, atp_500, atp_250, wta_premier, wta_international, atp_world_tour_finals, wta_championships, atp_next_generation, wta_elite_trophy, wta_master, wta_500, wta_250, wta_1000, wta_125
namesport_event_context - competitionStringName of a competition
ex. Wimbledon Men Singles, WTA Monterrey, Mexico Women Doubles
parent_idsport_event_context - competitionStringUnique parent ID for a competition.
ex. sr:competition:2553 is used to group all Wimbledon competitions.
typesport_event_context - competitionStringType of a competition
ex. sings, doubles, mixed_doubles
best_ofsport_event_context - modeIntegerNumber of sets in a 'best of' competition
Groups:
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group
ex. sr:league:150657 (2024 Wimbledon, London, Great Britain)
namesport_event_context - groups - groupStringName of a sport event's group
ex. 2024 Wimbledon, London, Great Britain
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
Season:
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a season belongs to
ex. sr:competition:2555 (Wimbledon Men Singles)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a season
ex. 2025-07-13
idseasonStringUnique ID for a season
ex. sr:season:120983 (Wimbledon Men Singles 2025)
namesport_event_context - seasonStringName of a season
ex. Wimbledon Men Singles 2025
start_datesport_event_context - seasonDateStart date of a season
ex. 2025-06-23
yearsport_event_context - seasonStringYear of a season
ex. 24/25 or 2025
Stages:
AttributeParent ElementTypeDescription
end_datesport_event_context - stageDateEnd date of a sport event's stage
ex. 2024-07-14
ordersport_event_context - stageIntegerOrder of a stage within a season
phasesport_event_context - stageStringName of a sport event's stage
ex. stage_1_playoff, qualification

See the enum_phase entry in our Tennis 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-06-24
typesport_event_context - stageStringType of a match's stage
cup, league
yearsport_event_context - stageStringYear of a match's stage
ex. 23/24 or 2024
Rounds:
AttributeParent ElementTypeDescription
namesport_event_context - roundStringName of a match's round
ex. quarterfinal or final
numbersport_event_context - roundIntegerNumber of a match's round
Competitor:

Competitors can be a player, a doubles team, or a national team

AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name
ex. PAU (Tommy Paul) or G/M ('Glasspool L / Middelkoop M' doubles team)
bracket_numbercompetitors - competitorIntegerIndicates the position in the bracket that the competitor is placed
countrycompetitors - competitorStringCountry of a competitor
ex. USA
country_codecompetitors - competitorStringCountry code of a competitor
ex. USA
gendercompetitors - competitorStringGender for a competitor
male, female
idcompetitors - competitorStringUnique ID for a competitor
ex. sr:competitor:138546
namecompetitors - competitorStringName for a competitor
ex. Paul, Tommy or Glasspool L / Middelkoop M (doubles team)
qualifiercompetitors - competitorStringDesignation of a competitor for a match
home, away
seedcompetitors - competitorIntegerSeed number for a competitor in a match
virtualcompetitors - competitorBooleanSignifies a competitor is virtual when true. Used for placeholder players/teams in TBD vs TBD matchups.
Player:

Competitors will appear under a players node when part of a doubles competition.

AttributeParent ElementTypeDescription
abbreviationcompetitor - players - playerStringAbbreviation for a competitor name
ex. PAU (Tommy Paul)
countrycompetitor - players - playerStringCountry of a competitor
ex. USA
country_codecompetitor - players - playerStringCountry code of a competitor
ex. USA
date_of_birthcompetitor - players - playerDateDate of birth of a player
ex. 1994-07-05
gendercompetitor - players - playerStringGender for a competitor
male, female
heightcompetitor - players - playerIntegerHeight of a player in centimeters
ex. 193
idcompetitor - players - playerStringUnique ID for a competitor
ex. sr:competitor:138546
namecompetitor - players - playerStringName for a competitor
ex. Paul, Tommy
nationalitycompetitor - players - playerStringNationality of a player
ex. Japan
virtualcompetitor - players - playerBooleanSignifies a competitor is virtual when true. Used for placeholder players/teams in TBD vs TBD matchups.
Coverage Properties:
AttributeParent ElementTypeDescription
typesport_event - coverageStringType of coverage for a match or competition. When type=sport_event coverage is described within sport_event_properties. If type="competition" coverage is described within sport_event_properties and competition_properties.
sport_event, competition
detailed_serve_outcomessport_event - coverage - sport_event_propertiesBooleanSignifies detailed serve outcomes are available for a match when true
extended_statssport_event - coverage - sport_event_propertiesBooleanSignifies extended stats are available for a match when true
play_by_playsport_event - coverage - sport_event_propertiesBooleanSignifies play-by-play events are available for a match when true
scoressport_event - coverage - sport_event_propertiesStringIndicates when match scores are made available
live, post (Post-match)
Game State:
AttributeParent ElementTypeDescription
advantagesport_event_status - game_stateStringSignifies the competitor with the advantage in the game
home, away
away_scoresport_event_status - game_stateIntegerScore for the away competitor in a game
ex. 0, 15, 30, 40
home_scoresport_event_status - game_stateIntegerScore for the home competitor in a game
ex. 0, 15, 30, 40
last_point_resultsport_event_status - game_stateStringResult of the last point in a game
server_winner, receiver_winner, ace, double_fault
point_typesport_event_status - game_stateStringType of point scored
game, break, set, match
servingsport_event_status - game_stateStringSignifies the competitor currently serving
home, away
tie_breaksport_event_status - game_stateBooleanSignifies a match is in a tie break when true
Sport Event:
AttributeParent ElementTypeDescription
estimatedsport_eventBooleanWhen true, signifies a match has an estimated start time based on the time of a previous match at the same venue.
idsport_eventStringUnique ID of a match
ex. sr:sport_event:51847153
parent_idsport_eventStringParent ID of a match
ex. sr:sport_event:51847153
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date
ex. sr:sport_event:51847153
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 match
ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a match is confirmed when true
Sport Event Status:
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away competitor in a match
decided_by_fedsport_event_statusBooleanSignifies a match result was decided by the federation when true. For example, incomplete due to crowd disruption
home_scoresport_event_statusIntegerTotal score for the home competitor in a match
match_statussport_event_statusStringStatus within a match (sport event). Provides more detail on the state of a match when live than status
ex. not_started, interrupted, 1st_set, walkover

See our FAQ for a complete list of statuses and their definitions.
scount_abandonedsport_event_statusBooleanSignifies a match 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 match winner
ex. sr:competitor:138546
winning_reasonsport_event_statusStringWinning reason description for a match
ex. walkover
Period Scores:
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway competitor set score
away_tiebreak_scoresport_event_status - period_scores - period_scoreIntegerAway competitor tiebreak set score
home_scoresport_event_status - period_scores - period_scoreIntegerHome competitor set score
home_tiebreak_scoresport_event_status - period_scores - period_scoreIntegerHome competitor tiebreak set score
numbersport_event_status - period_scores - period_scoreIntegerSet number
typesport_event_status - period_scores - period_scoreStringPeriod type
ex. set
Match Stats (Competitor):

See our Statistics FAQ Section for detailed descriptions of our tennis statistics

AttributeParent ElementTypeDescription
acescompetitor - statisticsIntegerNumber of aces for a competitor in a match
backhand_errorscompetitor - statisticsIntegerNumber of backhand errors for a competitor in a match
backhand_unforced_errorscompetitor - statisticsIntegerNumber of backhand unforced errors for a competitor in a match
backhand_winnerscompetitor - statisticsIntegerNumber of backhand winners for a competitor in a match
breakpoints_woncompetitor - statisticsIntegerNumber of breakpoints won for a competitor in a match
double_faultscompetitor - statisticsIntegerNumber of double faults for a competitor in a match
drop_shot_unforced_errorscompetitor - statisticsIntegerNumber of drop shot unforced errors for a competitor in a match
drop_shot_winnerscompetitor - statisticsIntegerNumber of drop shot winners for a competitor in a match
first_serve_points_woncompetitor - statisticsIntegerNumber of first serve points won for a competitor in a match
first_serve_successfulcompetitor - statisticsIntegerNumber of successful first serves for a competitor in a match
forehand_errorscompetitor - statisticsIntegerNumber of forehand errors for a competitor in a match
forehand_unforced_errorscompetitor - statisticsIntegerNumber of forehand unforced errors for a competitor in a match
forehand_winnerscompetitor - statisticsIntegerNumber of forehand winners for a competitor in a match
games_woncompetitor - statisticsIntegerNumber of games won for a competitor in a match
groundstroke_errorscompetitor - statisticsIntegerNumber of groundstroke errors for a competitor in a match
groundstroke_unforced_errorscompetitor - statisticsIntegerNumber of groundstroke unforced errors for a competitor in a match
groundstroke_winnerscompetitor - statisticsIntegerNumber of groundstroke winners for a competitor in a match
lob_unforced_errorscompetitor - statisticsIntegerNumber of lob unforced errors for a competitor in a match
lob_winnerscompetitor - statisticsIntegerNumber of lob winners for a competitor in a match
max_games_in_a_rowcompetitor - statisticsIntegerLongest game win streak for a competitor in a match
max_points_in_a_rowcompetitor - statisticsIntegerLongest point win streak for a competitor in a match
overhead_stroke_errorscompetitor - statisticsIntegerNumber of overhead errors for a competitor in a match
overhead_stroke_unforced_errorscompetitor - statisticsIntegerNumber of overhead unforced errors for a competitor in a match
overhead_stroke_winnerscompetitor - statisticsIntegerNumber of overhead winners for a competitor in a match
points_woncompetitor - statisticsIntegerNumber of points won for a competitor in a match
points_won_from_last_10competitor - statisticsIntegerNumber of points won in the last 10 opportunities for a competitor in a match
return_errorscompetitor - statisticsIntegerNumber of return errors for a competitor in a match
return_winnerscompetitor - statisticsIntegerNumber of return winners for a competitor in a match
second_serve_points_woncompetitor - statisticsIntegerNumber of second serve points won for a competitor in a match
second_serve_successfulcompetitor - statisticsIntegerNumber of successful second serves for a competitor in a match
service_games_woncompetitor - statisticsIntegerNumber of service games won for a competitor in a match
service_points_lostcompetitor - statisticsIntegerNumber of service points lost for a competitor in a match
service_points_woncompetitor - statisticsIntegerNumber of service points won for a competitor in a match
tiebreaks_woncompetitor - statisticsIntegerNumber of tiebreaks won for a competitor in a match
total_breakpointscompetitor - statisticsIntegerNumber of total breakpoints for a competitor in a match
volley_unforced_errorscompetitor - statisticsIntegerNumber of volley unforced errors for a competitor in a match
volley_winnerscompetitor - statisticsIntegerNumber of volley winners for a competitor in a match
Venue:
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue
ex. 14820
changedvenueBooleanSignifies a venue has been changed when true
city_namevenueStringCity name of a venue
ex. London
country_codevenueStringCountry code of a venue
ex. ENG (England)
country_namevenueStringCountry name of a venue
ex. England
idvenueStringUnique ID of a venue
ex. sr:venue:1846
map_coordinatesvenueStringCoordinates of a venue
ex. 54.707924, 25.236942
namevenueStringName of a venue
ex. Court 1, Center Court, or Astana 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/London
Language
Authorization
Query
Click Try It! to start a request and see the response here!