FAQs

What format are date fields presented in?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

What leagues or tournaments do you cover for Tennis?

We cover the following tours:

ATP Singles
ATP Doubles
Olympic Tournament
Challenger Tournaments Singles
Challenger Tournaments Doubles
Davis Cup
Exhibition
Match for Africa
Fed Cup
Hopman Cup
IPTL
ITF Singles
ITF Doubles
ITF Women Singles
ITF Women Doubles
WTA Singles
WTA Doubles
Olympic Tournament, Women
WTA 125K Singles
WTA 125K Doubles

What are the valid match modes?

bo5 (best of 5 sets), bo3 (Best of 3 sets)

What are the valid outcomes for probabilities?

Here are the valid outcome probabilities:

home_team_winner
away_team_winner

What are the valid sport_event_status – status values?

Status values can change over time, and new values may be added when needed. Here is a list of the currently valid status values and their definitions:

not_started – The match is scheduled to be played
match_about_to_start – The match time has expired, awaiting play
live – The match is currently in progress
closed – The match results have been confirmed.
ended – The match is over
interrupted - The match began, but coverage has stopped for a short time. Note that match scores may not be updated during this period, the last recorded match score will be displayed instead
suspended – The match began, but has been suspended to a later time
cancelled – The match has been cancelled and will not be played
delayed – The match has been temporarily delayed and will be continued
abandoned – The match began, but was then cancelled

What are the valid sport_event_status – match_status values?

Match status values can change over time, and new values may be added when needed. Here is a list of the currently valid match status values and their definitions:

not_started – The match is scheduled to be played
match_about_to_start – The match time has expired, awaiting play
start_delayed – The match has been temporarily delayed and will be continued. Matches are manually moved to this status 15 minutes after the scheduled start time.
live – The match is currently in progress
1st_set – First set
2nd_set – Second set
3rd_set – Third set
4th_set – Fourth set
5th_set – Fifth set
ended – The match is over
walkover - The match ended in a walkover
interrupted – The match began, but is stopped for a short time
suspended – The match began, but has been suspended to a later time
cancelled – The match has been cancelled and will not be played
postponed – The match has been postponed to a future date
abandoned – The match began, but was then cancelled
retired – The match is incomplete as the result of one player
closed – The match results have been confirmed
defaulted - The match has ended as a result of one player being disqualified
player_1_defaulted_player_2_won - The match has ended as a result of a 'player one' default
player_2_defaulted_player_1_won - The match has ended as a result of a 'player two' default

How do I find out the coverage for a particular match?

Find the node called: coverage_info. The attribute live_coverage reports whether Sportradar has live coverage of the match or not. The level can be gold, silver or bronze. Bronze includes basic_score. Silver includes basic_score and key_events. Gold includes everything in silver and detailed events and lineups.

What are the possible surface values?

Here are the possible surface values:

red clay
hardcourt indoor
hardcourt outdoor
grass
unknown

What are the possible weather conditions?

Here are the possible weather conditions:

indoor
good
medium
bad
extreme

What are the possible event types logged?

Here are all of the possible event types we log:

deciding_team
match_started
match_called
period_start
point
period_score
match_suspended
match_resumed
match_ended

What are the point event possible values?

Here are the possible values for a point event:

ace
receiver_won
server_won
double_fault

What are the valid tournament types?

Here are the valid tournament types:

group
playoff
qualifier
variable

What are markets and what are the different markets?

Markets is something you can bet on that we provide probabilities for. Over time we intend to provide more and more markets in the API. Currently the only market we provide is 3-way (will the home team win? Or the away team? Or will it be a draw?)

What are the possible outcomes?

Different markets have different outcomes. The available markets are currently:

home_team_winner
away_team_winner
draw

Is the statistical data provided in the Tennis API official data?

Sportradar collects sports data independently. For some sports Sportradar is the official data provider. In the case of Tennis, we provide official data for ITF tournaments only.

What are the possible name values within tournament_round?

Here is a list of possible values for tournament_round – name:

11th_place_final
13th_place_final
15th_place_final
17th_place_final
19th_place_final
21st_place_final
23rd_place_final
2nd_place_final
3rd_place_final
3rd_place_playoff
4th_place_final
5th_place_final
7th_place_final
9th_place_final
decider_match
final
initial_match
losers_final
losers_match
losers_quarterfinal
losers_round_1
losers_round_2
losers_round_3
losers_round_4
losers_round_5
losers_round_of_16
losers_semifinal
placement_qualification_match
qualification
quarterfinal
round_of_128
round_of_16
round_of_256
round_of_32
round_of_64
semifinal
winners_final
winners_match
winners_quarterfinal
winners_round_1
winners_round_2
winners_round_3
winners_round_4
winners_round_5
winners_round_of_16
winners_semifinal

Why do some players have height and weight data and others don't?

Only the height and weight of the top 500 ranked players for ATP and WTA are included. There may be some instances where some players outside of the top 500 have these attributes but should not be relied upon.

What are the possible name values in the category node?

Listed below are the possible name values for category – name. Note that new values can be added at any time.

ATP
Challenger
Davis Cup
Exhibition
Federation Cup
Hopman Cup
IPTL
ITF Men
ITF Women
Juniors
Legends
WTA 125K
WTA
Wheelchairs

What are the possible values of level in the category node?

Here is a list of possible values for category – level:

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

How are statistics handled at a match level?

All match statistics start at 0 and can change while events unfold. Though, if detailed_service_outcomes is false then the following stats are not collected:

aces
double-faults
second_serve_points_won

How long are matches stored in the deleted/updated matches endpoints?

The deleted/updated matches endpoints will show sport events removed or updated in the last 2 weeks.

How do venues work for country vs country competitions?

To explain, in country vs country competitions such as Davis Cup and ATP Cup, venues on the parent matches refer to the complex in which the courts are located, and on the child match level venue refers to the court where the match is played. Note that only the finals venue will be linked to complex attribute for the Davis Cup competition.

How does sport event type work in the feeds?

The sport_event_type explicitly denotes the match type. Where there are tournaments which have "parent matches" and "child matches" where country_format='true', such as Davis Cup and ATP Cup, this attribute will only appear on the "child match" node. The "parent match" sport_event node will have a "type='parent'" attribute and the "tournament" node will have a "type='mixed'" attribute. Otherwise, for competitions where "country_format" is not present, the tournament will have a type either "singles" or "doubles".

How do I detect when one player has "advantage" in the case where the players both reached "40" or "deuce"?

The player who has "advantage" will have a score of "50" in the timeline, for example this is how a game was won by the receiver after a server committed a double_fault when the receiver was at "advantage":

<event id="691865865" type="point" time="2020-05-29T11:30:37+00:00" team="home" 
home_score="50" away_score="40" server="away" result="double_fault" first_serve_fault="true"/>

<event id="691866221" type="period_score" time="2020-05-29T11:31:22+00:00" period="2" 
home_score="4" away_score="4" server="away" result="receiver_won"/>

In addition, when in a live situation the "game_state" node will display the following:

<game_state home_score="50" away_score="40" serving="away" last_point_result="receiver_winner" 
advantage="home" tie_break="false" ball_status="first_serve"/>