Live Tennis APITennis data codes: tours, rounds, surfaces and match formats
60 codes that tennis results and live data use, in four groups: tours and tiers, rounds, surfaces and match formats. Each one links the rulebook or official page that defines it. This is an unofficial index, free to reuse under CC BY 4.0.
Download the CSVLicence: CC BY 4.0
What are the tour and tier names?
| Code | Name | What it means | Source |
|---|---|---|---|
Grand Slam | Grand Slam tournament | One of the four official international championships: Australia, France, Great Britain and the United States. | Official Grand Slam Rule Book 2026Grand Slam Rules, Article I.B |
ATP Finals | ATP Finals | The ATP season finale. Eight singles players in two round-robin groups of four, then semi-finals and a final. | ATP Official Rulebook 2026Rule 4.01 A |
Next Gen ATP Finals | Next Gen ATP Finals | An eight-player round-robin event with its own short-set format. | ATP Official Rulebook 2026Rule 4.04 A |
United Cup | United Cup | A yearly mixed team event between 18 countries. | ATP Official Rulebook 2026Rule 4.03 |
ATP Tour Masters 1000 | ATP Masters 1000 | The top tier of regular ATP Tour events. The winner earns 1,000 ranking points. | ATP Official Rulebook 2026Rule 1.01 and points table 9.03 |
ATP Tour 500 | ATP 500 | ATP Tour tier below the Masters 1000. The winner earns 500 ranking points. | ATP Official Rulebook 2026Rule 1.01 and points table 9.03 |
ATP Tour 250 | ATP 250 | ATP Tour tier below the 500s. The winner earns 250 ranking points. | ATP Official Rulebook 2026Rule 1.01 and points table 9.03 |
Challenger 175 | ATP Challenger 175 | Top ATP Challenger Tour tier, named for the winner's 175 ranking points. | ATP Official Rulebook 2026Points table 9.03 |
Challenger 125 | ATP Challenger 125 | ATP Challenger Tour tier. The winner earns 125 ranking points. | ATP Official Rulebook 2026Points table 9.03 |
Challenger 100 | ATP Challenger 100 | ATP Challenger Tour tier. The winner earns 100 ranking points. | ATP Official Rulebook 2026Points table 9.03 |
Challenger 75 | ATP Challenger 75 | ATP Challenger Tour tier. The winner earns 75 ranking points. | ATP Official Rulebook 2026Points table 9.03 |
Challenger 50 | ATP Challenger 50 | Lowest ATP Challenger Tour tier. The winner earns 50 ranking points. | ATP Official Rulebook 2026Points table 9.03 |
Davis Cup | Davis Cup | The men's team competition between nations. The ATP lists it as one of the categories of official men's events. | ATP Official Rulebook 2026Rule 1.01 |
WTA Finals | WTA Finals | The WTA season finale. Eight singles players and eight doubles teams, each in two round-robin groups of four. | WTA Official Rulebook 2026Section VI.B.1 |
WTA 1000 | WTA 1000 | The top tier of regular WTA Tour events. | WTA Official Rulebook 2026Section I.B and points chart VIII.A.5 |
WTA 500 | WTA 500 | WTA Tour tier below the WTA 1000s. | WTA Official Rulebook 2026Section I.B and points chart VIII.A.5 |
WTA 250 | WTA 250 | WTA Tour tier below the WTA 500s. | WTA Official Rulebook 2026Section I.B and points chart VIII.A.5 |
WTA 125 | WTA 125 | The tier below the WTA 250s, listed in the WTA ranking points chart. | WTA Official Rulebook 2026Points chart VIII.A.5 |
M15 | Men's ITF World Tennis Tour, $15,000 | A men's ITF World Tennis Tour event offering $15,000 in prize money. | ITF World Tennis Tour Regulations 2026Men's regulations I.A.1 |
M25 | Men's ITF World Tennis Tour, $30,000 | A men's ITF World Tennis Tour event offering $30,000 in prize money. The name stays M25. | ITF World Tennis Tour Regulations 2026Men's regulations I.A.1 |
W15 | Women's ITF World Tennis Tour, $15,000 | A women's ITF World Tennis Tour event offering $15,000 in prize money. | ITF World Tennis Tour Regulations 2026Women's regulations I.A.1 |
W35 | Women's ITF World Tennis Tour, $30,000 | A women's ITF World Tennis Tour event offering $30,000 in prize money. | ITF World Tennis Tour Regulations 2026Women's regulations I.A.1 |
W50 | Women's ITF World Tennis Tour, $40,000 | A women's ITF World Tennis Tour event offering $40,000 in prize money. | ITF World Tennis Tour Regulations 2026Women's regulations I.A.1 |
W75 | Women's ITF World Tennis Tour, $60,000 | A women's ITF World Tennis Tour event offering $60,000 in prize money. | ITF World Tennis Tour Regulations 2026Women's regulations I.A.1 |
W100 | Women's ITF World Tennis Tour, $100,000 | A women's ITF World Tennis Tour event offering $100,000 in prize money. | ITF World Tennis Tour Regulations 2026Women's regulations I.A.1 |
25 rows. Sources read on 8 November 2026.
What do the round codes mean?
| Code | Name | What it means | Source |
|---|---|---|---|
Q1 | Qualifying round 1 | The first round of the qualifying draw. | WTA Official Rulebook 2026Column heading, points chart VIII.A.5 |
Q2 | Qualifying round 2 | The second round of the qualifying draw. | WTA Official Rulebook 2026Column heading, points chart VIII.A.5 |
Q3 | Qualifying round 3 | The third qualifying round, where a draw has one. | WTA Official Rulebook 2026Column heading, points chart VIII.A.5 |
R128 | Round of 128 | The first round of a 128-player draw. Grand Slam singles main and qualifying draws hold at most 128 players. | Official Grand Slam Rule Book 2026Grand Slam Regulations, Article I.C |
R64 | Round of 64 | The round with 64 players left. | WTA Official Rulebook 2026Column heading, points chart VIII.A.5 |
R32 | Round of 32 | The round with 32 players left. | WTA Official Rulebook 2026Column heading, points chart VIII.A.5 |
R16 | Round of 16 | The round with 16 players left. | WTA Official Rulebook 2026Column heading, points chart VIII.A.5 |
QF | Quarter-final | The round with eight players left. | WTA Official Rulebook 2026Column heading, points chart VIII.A.5 |
SF | Semi-final | The round with four players left. | WTA Official Rulebook 2026Column heading, points chart VIII.A.5 |
F | Final | The last match of the draw. | WTA Official Rulebook 2026Column heading, points chart VIII.A.5 |
W | Winner | The points column for the player who wins the final. A result, not a round. | WTA Official Rulebook 2026Column heading, points chart VIII.A.5 |
RR | Round robin | Group stage where everyone in a group plays everyone else. RR is common usage. The rulebooks define the format but not the abbreviation. | ATP Official Rulebook 2026Rule 4.01 A (ATP Finals) |
12 rows. Sources read on 8 November 2026.
Which surface values are used?
| Code | Name | What it means | Source |
|---|---|---|---|
hard | Hard court | One of the three outdoor surface classes in the ATP rules. | ATP Official Rulebook 2026Rule 6.01 A |
clay | Clay court | One of the three outdoor surface classes in the ATP rules. | ATP Official Rulebook 2026Rule 6.01 A |
grass | Grass court | One of the three outdoor surface classes in the ATP rules. | ATP Official Rulebook 2026Rule 6.01 A |
indoor hard | Indoor hard court | The ATP's default class for indoor courts, unless another surface is approved. | ATP Official Rulebook 2026Rule 6.01 A |
carpet | Carpet | Textile or polymer material laid in rolls or sheets. The ITF lists it as a construction type, not a pace. | ITF Surface TypesSurface types table |
Category 1 to 5 | ITF court pace category | Court pace from Category 1 (slow, rating 0 to 29) to Category 5 (fast, 45 and over). | ITF Rules of Tennis 2026Appendix I |
6 rows. Sources read on 8 November 2026.
Which match formats are played, and where?
| Code | Name | What it means | Source |
|---|---|---|---|
Best of 3 sets | Best of three sets | The first player or team to win two sets wins the match. | ITF Rules of Tennis 2026Rule 7 |
Best of 5 sets | Best of five sets | The first player or team to win three sets wins the match. | ITF Rules of Tennis 2026Rule 7 |
Tie-break (7 points) | Tie-break game | At six games all, a tie-break game: first to 7 points with a margin of two wins the set. | ITF Rules of Tennis 2026Rule 5b |
Match tie-break (10 points) | Match tie-break | One tie-break game replaces the deciding set: first to 10 points with a margin of two. | ITF Rules of Tennis 2026Appendix VI.4 |
Final set tie-break (10 points) | Final set tie-break | At six games all in the final set, a 10-point tie-break decides the match. | ITF Rules of Tennis 2026Appendix VI.5 |
No-Ad | No-Ad scoring | At deuce one deciding point is played, and the receiver chooses the side to receive from. | ITF Rules of Tennis 2026Appendix VI |
Short sets | Short sets | The first to four games with a margin of two wins the set, with a tie-break at four games all. | ITF Rules of Tennis 2026Appendix VI.1 |
Grand Slams | Grand Slam singles and the final set | Men's singles main draw is best of five sets, other matches best of three unless the event decides otherwise. The final set has a 10-point tie-break. | Official Grand Slam Rule Book 2026Grand Slam Regulations, Article I.L |
Australian Open | Australian Open final set | All final sets are decided by a 10-point tie-break at six games all, first used at the 2019 Australian Open. | Australian Open: a guide to scoringArticle |
Roland-Garros | Roland-Garros final set | A 10-point final-set tie-break was introduced in 2022 in the singles and doubles events. | Roland-Garros 2022 innovationsArticle |
Wimbledon | Wimbledon final set | Wimbledon publishes the same Grand Slam Rule Book: a 10-point tie-break in the final set. | Official Grand Slam Rule Book 2026Copy hosted by Wimbledon, Article I.L |
US Open | US Open deciding set | At 6-6 in the deciding set a 10-point tie-break is played. | US Open 101Page |
ATP singles | ATP Tour singles | All matches, finals included, are best of three tie-break sets. | ATP Official Rulebook 2026Rule 1.02 B 1 |
ATP doubles | ATP Tour doubles | Two tie-break sets, then a 10-point match tie-break at one set all. Games use No-Ad scoring. | ATP Official Rulebook 2026Rule 1.02 B 2 |
Next Gen ATP Finals | Next Gen ATP Finals format | Best of five sets of four games, with a tie-break at three games all and No-Ad scoring. | ATP Official Rulebook 2026Rule 4.04 A |
WTA singles and doubles | WTA Tour | Singles: best of three tie-break sets. Main draw doubles: No-Ad in the first two sets and a 10-point match tie-break as the third. | WTA Official Rulebook 2026Section XVIII.39 |
ITF World Tennis Tour | ITF World Tennis Tour | Singles qualifying and doubles: two tie-break sets, then a 10-point match tie-break at one set all. Qualifying uses Ad scoring, doubles No-Ad. | ITF World Tennis Tour Regulations 2026Men's regulations III.E (same text for women) |
17 rows. Sources read on 8 November 2026.
Can I reuse the list?
Yes. The CSV is under CC BY 4.0, so you can copy and change it, commercial use included. Credit Live Tennis API. A credit line that works is "Tennis data codes: Live Tennis API (livetennisapi.com/data/tennis-codes), CC BY 4.0."
The CSV has one row per code, with the columns category, code, name, definition, source_name, source_url, source_section and checked. It is UTF-8 with a header row.
Rulebooks change every season. If a source moved or a rule changed, write to hello@livetennisapi.com and we will check it again.
How do these codes look in a live feed? The score notation comparison sets the open formats side by side. Our own score object is in the API documentation.
Every source was read on 8 November 2026.