Mock tennis match data generator
Pick a seed and get random tennis matches that follow the scoring rules, in the JSON shape of our Match object. Every record is synthetic.
Synthetic data. These matches never happened. Every record carries "synthetic": true, and the player and tournament names are built from made-up syllables.
The generator runs in your browser and needs JavaScript. Without it, this page shows the 10 matches for the seed rally with the default options.
10 matches from seed rally
| # | Players | Score | Outcome |
|---|---|---|---|
| 1 | Fennane WuldeskYvessa Luskib won | 6-4 2-6 5-7 | Completed |
| 2 | Sefessa Faskoy wonIlvane Wuldib | 6-2 7-6 | Completed |
| 3 | Luxen Crellik wonNarlis Quilane | 5-7 6-4 7-6 | Completed |
| 4 | Vexen HivastTauvoth Garthammer won | 1-6 2-6 | Completed |
| 5 | Luxette Snevane wonIlvim Hivane | 4-6 6-3 6-4 | Completed |
| 6 | Quelix HivovarThesar Ulvent won | 4-6 3-6 | Completed |
| 7 | Druim VanthorraFennoth Luskent won | 4-6 4-6 | Completed |
| 8 | Quelane SnevovarNarlulo Ulvettio won | 4-6 2-6 | Completed |
| 9 | Druis Luskoy wonEbbessa Snevettio | 7-6 6-3 | Completed |
| 10 | Quelim UlvibZorette Quilik won | 4-6 1-6 | Completed |
Scores read player 1 first, one pair of games per set.
The first match as JSON
{
"id": 997058719,
"tournament": "Orrholt Classic",
"tournament_id": "mock-orrholt-classic-atp",
"tour": "atp",
"gender": "men",
"surface": "clay",
"indoor": true,
"format": "BO3",
"round": "Quarter-finals",
"round_code": "QF",
"is_qualifying": false,
"status": "completed",
"event_status": "Finished",
"outcome": "completed",
"is_doubles": false,
"draw": "singles",
"scheduled_time": "2026-06-02T11:30:00Z",
"players": {
"p1": {
"id": 964468835,
"name": "Fennane Wuldesk",
"tour": "atp",
"country": null,
"ranking": 371,
"hand": "R",
"is_doubles_team": false
},
"p2": {
"id": 952083427,
"name": "Yvessa Luskib",
"tour": "atp",
"country": null,
"ranking": 192,
"hand": "R",
"is_doubles_team": false
}
},
"score": {
"sets": [
1,
2
],
"games": [
[
6,
2,
5
],
[
4,
6,
7
]
],
"points": [
"0",
"0"
],
"server": 2,
"is_tiebreak": false
},
"winner": 2,
"server1": 1,
"final_set": "tb7",
"pbp": "RRRSSR;SRSRSS;RSSSS;RSSSDS;SSRRSS;RSSRSS;SSRSS;RSRRR;SSSS;SSSDDDRR.SSSRS;SRSSS;RDRSD;RSSSA;SRRRSR;ASSS;RARSRSRSSS;DSSSS.SRSAS;SRARSS;RSARARAS;RDSRSSSS;SSAS;SRSRRSSRSS;SSRSS;RSRSSRSDSRSS;DSSSA;SSRSS;SRRSRASRDR;RSSSS.",
"synthetic": true
}
The generator works in your browser and sends nothing. The files are built on your device when you press a download button.
Get a free API keyRead a point string
What is it for?
For anything that needs tennis matches that look real but are not.
- UI tests. Fixed seeds give the same matches on every run, so a scoreboard, a results list or a parser can be tested against known output. Five-set matches, long final sets, retirements and walkovers cover the cases a real day may not.
- Demos. Fill a screen with plausible matches without real names or live data.
- Teaching. Students can parse, store and chart the files. Our coding exercises for teachers work with the same shape.
It is not a model of tennis. Serve strengths, rankings and dates are random draws, so the figures say nothing about real players or real matches.
What is in each record?
Each record follows the Match object of our API, with the field names and values of our published OpenAPI document. It holds the main fields of a finished singles match.
id,tournament,tournament_id,tour,gender,surface,indoor,format,roundandround_code.statusis alwayscompleted.event_statusandoutcomesay whether the match was finished, ended in a retirement or was a walkover.playersholdsp1andp2with an id, a name, a ranking and a hand.countryis null.scoreholds five of the Score fields:sets,games,points,serverandis_tiebreak.winneris 1 or 2. After a retirement or a walkover,withdrewnames the player who stopped.
A retirement keeps the score at the point where play stopped. A walkover has no score, so score is null.
Four keys are not part of the Match object. synthetic is always true. With point strings on, pbp holds the string in the notation our score converter reads. server1 says who served first and final_set names the final-set rule, the two other things the converter needs to read it.
How are the matches played?
Point by point. Each player gets a random chance of winning a point on serve, between 58 and 70 percent. For each point the generator draws who wins it and writes S, A, R or D.
The score is kept by the parser of our point string to score converter, the same code that page runs. After each point the parser says whether a game, a set or the match is over and who serves next. The generator then adds a semicolon, a full stop or a tie-break slash. So every string reads back in the converter with the same match length and final set. The score in each record is what the converter gives for it.
Best of three and best of five follow the usual rules. At six games all in the final set you can pick a tie-break to 7, a tie-break to 10 or no tie-break. Best of five gives men's matches only.
With walkovers on, each match has a one in twenty chance of being a walkover. With retirements on, each other match has a one in ten chance of being picked to stop early, and the other player then wins. A picked match that ends before its stopping point stands as finished.
How do the seed and the link work?
The seed starts a random number generator that gives the same numbers in every browser. Same seed, same options, same matches. A new seed gives new matches. Turning retirements or walkovers on changes only the matches they touch.
The page address carries the seed and the options, so Copy link gives a link that opens the same matches. For example:
https://livetennisapi.com/tools/mock-tennis-data?seed=demo&count=5&sets=5&final=tb7&ret=1&wo=0&pbp=1
The keys are seed, count, sets (3 or 5), final (tb7, tb10 or adv), and ret, wo and pbp (1 or 0).
What do the JSON and CSV files hold?
The JSON file holds the seed, the options and the records under data, as a list call to our API holds matches. The CSV file has one row per match. Player fields get a p1_ or p2_ prefix, and the games of each set are joined by spaces in games_p1 and games_p2. An empty cell means null.
Here is how the default sample begins. The seed rally with the default options gives 10 matches at the made-up Orrholt Classic. In the first, player 2, Yvessa Luskib, beats Fennane Wuldesk 4-6 6-2 7-5 over 185 points.
Checked against our OpenAPI document and the score converter on 17 November 2026.