Tennis API Tech Docs

Search in tech docs

Tennis API Match List: All

Provides the daily match list in active season and includes scheduled, live and finished matches.

Tennis Match List: All Request URL

GET

References / Dependencies

There is no references/dependencies for Match List. Match List endpoints works with only date parameter.

Call Rate / Interval

Recommended API Call Interval: 20 Request / Minute Daily Max API Call: 28800 Request

± 7 days Match Period

Match List data can be retrieved for only ± 7 days.

Request Headers

Data	Type	O / R	Example	Description
languageId	INT	R	{languageId}	The id of the language that you select.
Ocp-Apim-Subscription-Key	STR	R	{yourOcp-Apim-Subscription-Key}	Your account key.
Accept	STR	O	application/xml	Selection of data presentation type as XML/JSON.

^*O= Optional, R= Required

Request Parameters

Data	Type	O / R	Example	Description
date	DATE/STR	R	{dd/MM/yyyy}	Date of the match

Response Output

[ { "homeTeam": { "scores": { "set1": 7, "set2": 3, "set3": 5, "current": 1 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "United States of America", "shortName": "USA", "id": 18 }, "knownName": "Taylor Townsend", "name": "Taylor", "surName": "Townsend", "middleName": "", "id": 1968 } }, "awayTeam": { "scores": { "set1": 5, "set2": 6, "set3": 7, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "France", "shortName": "FRA", "id": 9 }, "knownName": "Caroline Garcia", "name": "Caroline", "surName": "Garcia", "middleName": "", "id": 897 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 02:10:00", "id": 92155, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "ASB Classic WTA", "shortName": "ASB", "id": 78 }, "stage": { "name": "Round 1", "shortName": "", "id": 14630 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 0, "set2": 4, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "United States of America", "shortName": "USA", "id": 18 }, "knownName": "Catherine Cartan Bellis", "name": "Catherine", "surName": "Bellis", "middleName": "Cartan", "id": 2133 } }, "awayTeam": { "scores": { "set1": 6, "set2": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "United States of America", "shortName": "USA", "id": 18 }, "knownName": "Jessica Pegula", "name": "Jessica", "surName": "Pegula", "middleName": "", "id": 1676 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 02:10:00", "id": 92153, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "ASB Classic WTA", "shortName": "ASB", "id": 78 }, "stage": { "name": "Round 1", "shortName": "", "id": 14630 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 3, "set2": 6, "set3": 2, "current": 1 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "knownName": "Carla Suarez Navarro", "name": "Carla ", "surName": "Navarro", "middleName": "Suarez ", "id": 355 } }, "awayTeam": { "scores": { "set1": 6, "set2": 3, "set3": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Russia", "shortName": "RUS", "id": 23 }, "knownName": "Darya Kasatkina", "name": "Daria", "surName": "Kasatkina", "middleName": "", "id": 2151 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 02:40:00", "id": 92154, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "ASB Classic WTA", "shortName": "ASB", "id": 78 }, "stage": { "name": "Round 1", "shortName": "", "id": 14630 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "United States of America", "shortName": "USA", "id": 18 }, "knownName": "Cori Gauff", "name": "Cori", "surName": "Gauff", "middleName": "", "id": 2563 } }, "awayTeam": { "scores": { "set1": 3, "set2": 1, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Slovakia", "shortName": "SVK", "id": 56 }, "knownName": "Viktoria Kuzmova", "name": "Viktoria", "surName": "Kuzmova", "middleName": "", "id": 2439 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 03:40:00", "id": 92158, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "ASB Classic WTA", "shortName": "ASB", "id": 78 }, "stage": { "name": "Round 1", "shortName": "", "id": 14630 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 6, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Sweden", "shortName": "SWE", "id": 11 }, "knownName": "Rebecca Peterson", "name": "Rebecca", "surName": "Peterson", "middleName": "", "id": 1905 } }, "awayTeam": { "scores": { "set1": 7, "set2": 7, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Slovenia", "shortName": "SLV", "id": 19 }, "knownName": "Tamara Zidansek", "name": "Tamara", "surName": "Zidansek", "middleName": "", "id": 2503 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 03:40:00", "id": 92156, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "ASB Classic WTA", "shortName": "ASB", "id": 78 }, "stage": { "name": "Round 1", "shortName": "", "id": 14630 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 3, "set2": 0, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Russia", "shortName": "RUS", "id": 23 }, "knownName": "Margarita Gasparyan", "name": "Margarita", "surName": "Gasparyan", "middleName": "", "id": 1943 } }, "awayTeam": { "scores": { "set1": 6, "set2": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Belarus", "shortName": "BLR", "id": 51 }, "knownName": "Aryna Sabalenka", "name": "Aryna", "surName": "Sabalenka", "middleName": "", "id": 2379 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 03:40:00", "id": 92141, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Shenzhen Open", "shortName": "SO", "id": 191 }, "stage": { "name": "Round 1", "shortName": "", "id": 14625 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 5, "set3": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "United States of America", "shortName": "USA", "id": 18 }, "knownName": "Shelby Rogers", "name": "Shelby", "surName": "Rogers", "middleName": "", "id": 1247 } }, "awayTeam": { "scores": { "set1": 3, "set2": 7, "set3": 4, "current": 1 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "United States of America", "shortName": "USA", "id": 18 }, "knownName": "Nicole Gibbs", "name": "Nicole", "surName": "Gibbs", "middleName": "", "id": 2034 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 03:40:00", "id": 92142, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Shenzhen Open", "shortName": "SO", "id": 191 }, "stage": { "name": "Round 1", "shortName": "", "id": 14625 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 1, "set3": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Russia", "shortName": "RUS", "id": 23 }, "knownName": "Elena Rybakina", "name": "Elena", "surName": "Rybakina", "middleName": "", "id": 2459 } }, "awayTeam": { "scores": { "set1": 2, "set2": 6, "set3": 2, "current": 1 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "China", "shortName": "CHI", "id": 116 }, "knownName": "Saisai Zheng", "name": "Saisai", "surName": "Zheng", "middleName": "", "id": 1595 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 03:40:00", "id": 92143, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Shenzhen Open", "shortName": "SO", "id": 191 }, "stage": { "name": "Round 1", "shortName": "", "id": 14625 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Switzerland", "shortName": "SWI", "id": 36 }, "knownName": "Jil Teichmann", "name": "Jil", "surName": "Teichmann", "middleName": "Belen", "id": 2290 } }, "awayTeam": { "scores": { "set1": 4, "set2": 3, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "New Zealand", "shortName": "NZL", "id": 86 }, "knownName": "Valentina Ivanov", "name": "Valentina", "surName": "Ivanov", "middleName": "", "id": 2627 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 04:40:00", "id": 92157, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "ASB Classic WTA", "shortName": "ASB", "id": 78 }, "stage": { "name": "Round 1", "shortName": "", "id": 14630 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 2, "set2": 6, "set3": 3, "current": 1 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "United Kingdom", "shortName": "UK", "id": 160 }, "knownName": "Johanna Konta", "name": "Johanna", "surName": "Konta", "middleName": "", "id": 1490 } }, "awayTeam": { "scores": { "set1": 6, "set2": 3, "set3": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Czechia", "shortName": "CZE", "id": 20 }, "knownName": "Barbora Zahlavova Strycova", "name": "Barbora ", "surName": "Strycova", "middleName": "Zahlavova ", "id": 340 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 04:40:00", "id": 92127, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Brisbane International WTA", "shortName": "BRI", "id": 79 }, "stage": { "name": "Round 1", "shortName": "", "id": 14620 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 7, "set2": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Russia", "shortName": "RUS", "id": 23 }, "knownName": "Sofia Kenin", "name": "Sofia", "surName": "Kenin", "middleName": "", "id": 2217 } }, "awayTeam": { "scores": { "set1": 6, "set2": 4, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Latvia", "shortName": "LVA", "id": 55 }, "knownName": "Anastasija Sevastova", "name": "Anastasija", "surName": "Sevastova", "middleName": "", "id": 452 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 04:40:00", "id": 92126, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Brisbane International WTA", "shortName": "BRI", "id": 79 }, "stage": { "name": "Round 1", "shortName": "", "id": 14620 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Czechia", "shortName": "CZE", "id": 20 }, "knownName": "Kristyna Pliskova", "name": "Kristyna", "surName": "Pliskova", "middleName": "", "id": 1214 } }, "awayTeam": { "scores": { "set1": 3, "set2": 3, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Romania", "shortName": "ROU", "id": 22 }, "knownName": "Irina Begu", "name": "Irina", "surName": "Begu", "middleName": "Camelia", "id": 544 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 05:10:00", "id": 92144, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Shenzhen Open", "shortName": "SO", "id": 191 }, "stage": { "name": "Round 1", "shortName": "", "id": 14625 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 3, "set3": 0, "current": 1 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "China", "shortName": "CHI", "id": 116 }, "knownName": "Xin Yu Wang", "name": "Xin Yu", "surName": "Wang", "middleName": "", "id": 2470 } }, "awayTeam": { "scores": { "set1": 3, "set2": 6, "set3": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "knownName": "Garbine Muguruza Blanco", "name": "Garbine", "surName": "Blanco", "middleName": "Muguruza", "id": 1678 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 05:10:00", "id": 92146, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Shenzhen Open", "shortName": "SO", "id": 191 }, "stage": { "name": "Round 1", "shortName": "", "id": 14625 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Belarus", "shortName": "BLR", "id": 51 }, "knownName": "Aliaksandra Sasnovich", "name": "Aliaksandra", "surName": "Sasnovich", "middleName": "", "id": 2131 } }, "awayTeam": { "scores": { "set1": 2, "set2": 3, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Germany", "shortName": "GER", "id": 8 }, "knownName": "Anna-Lena Friedsam", "name": "Anna-Lena", "surName": "Friedsam", "middleName": "", "id": 2056 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 05:50:00", "id": 92145, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Shenzhen Open", "shortName": "SO", "id": 191 }, "stage": { "name": "Round 1", "shortName": "", "id": 14625 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "China", "shortName": "CHI", "id": 116 }, "knownName": "Qiang Wang", "name": "Qiang", "surName": "Wang", "middleName": "", "id": 1909 } }, "awayTeam": { "scores": { "set1": 0, "set2": 3, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Tunisia", "shortName": "TUN", "id": 29 }, "knownName": "Ons Jabeur", "name": "Ons", "surName": "Jabeur", "middleName": "", "id": 1665 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 06:25:00", "id": 92148, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Shenzhen Open", "shortName": "SO", "id": 191 }, "stage": { "name": "Round 1", "shortName": "", "id": 14625 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 7, "set2": 7, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Australia", "shortName": "AUS", "id": 6 }, "knownName": "Samantha Stosur", "name": "Samantha", "surName": "Stosur", "middleName": "", "id": 67 } }, "awayTeam": { "scores": { "set1": 6, "set2": 6, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Germany", "shortName": "GER", "id": 8 }, "knownName": "Angelique Kerber", "name": "Angelique ", "surName": "Kerber", "middleName": "", "id": 421 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 06:45:00", "id": 92129, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Brisbane International WTA", "shortName": "BRI", "id": 79 }, "stage": { "name": "Round 1", "shortName": "", "id": 14620 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "United States of America", "shortName": "USA", "id": 18 }, "knownName": "Alison Riske", "name": "Alison", "surName": "Riske", "middleName": "", "id": 693 } }, "awayTeam": { "scores": { "set1": 4, "set2": 2, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Czechia", "shortName": "CZE", "id": 20 }, "knownName": "Karolina Muchova", "name": "Karolina", "surName": "Muchova", "middleName": "", "id": 2447 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 06:45:00", "id": 92128, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Brisbane International WTA", "shortName": "BRI", "id": 79
}, "stage": { "name": "Round 1", "shortName": "", "id": 14620 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 3, "set3": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "China", "shortName": "CHI", "id": 116 }, "knownName": "Shuai Peng", "name": "Shuai", "surName": "Peng", "middleName": "", "id": 398 } }, "awayTeam": { "scores": { "set1": 2, "set2": 6, "set3": 3, "current": 1 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "China", "shortName": "CHI", "id": 116 }, "knownName": "Lin Zhu", "name": "Lin", "surName": "Zhu", "middleName": "", "id": 2137 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 06:50:00", "id": 92147, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Shenzhen Open", "shortName": "SO", "id": 191 }, "stage": { "name": "Round 1", "shortName": "", "id": 14625 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 7, "set2": 7, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Canada", "shortName": "CAN", "id": 24 }, "knownName": "Eugenie Bouchard", "name": "Eugenie", "surName": "Bouchard", "middleName": "", "id": 1583 } }, "awayTeam": { "scores": { "set1": 5, "set2": 5, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Belgium", "shortName": "BEL", "id": 16 }, "knownName": "Kirsten Flipkens", "name": "Kirsten", "surName": "Flipkens", "middleName": "", "id": 458 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 07:50:00", "id": 92159, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "ASB Classic WTA", "shortName": "ASB", "id": 78 }, "stage": { "name": "Round 1", "shortName": "", "id": 14630 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 6, "set2": 4, "set3": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Croatia", "shortName": "CRO", "id": 40 }, "knownName": "Ajla Tomljanovic", "name": "Ajla", "surName": "Tomljanovic", "middleName": "", "id": 514 } }, "awayTeam": { "scores": { "set1": 2, "set2": 6, "set3": 4, "current": 1 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Australia", "shortName": "AUS", "id": 6 }, "knownName": "Priscilla Hon", "name": "Priscilla", "surName": "Hon", "middleName": "", "id": 2235 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 08:15:00", "id": 92131, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Brisbane International WTA", "shortName": "BRI", "id": 79 }, "stage": { "name": "Round 1", "shortName": "", "id": 14620 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 1, "set2": 1, "current": 0 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "Ukraine", "shortName": "UKR", "id": 47 }, "knownName": "Elina Svitolina", "name": "Elina", "surName": "Svitolina", "middleName": "", "id": 1912 } }, "awayTeam": { "scores": { "set1": 6, "set2": 6, "current": 2 }, "player1": { "gender": { "name": "Women", "id": 2 }, "country": { "name": "United States of America", "shortName": "USA", "id": 18 }, "knownName": "Danielle Collins", "name": "Danielle", "surName": "Collins", "middleName": "Rose", "id": 2130 } }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/01/2020 09:00:00", "id": 92130, "tournament": { "courtType": { "isHardCourt": true }, "type": { "isTournamentType": true }, "participantType": { "isSingles": true }, "gender": { "name": "Women", "id": 2 }, "name": "Brisbane International WTA", "shortName": "BRI", "id": 79 }, "stage": { "name": "Round 1", "shortName": "", "id": 14620 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } } ]

sample 1

Response Output Definitions

match

Data

Type

Example

Description

date

DATE/STR

06/01/2020 07:50:00

The starting date of the match, includes also time

INT

92159

The id of the match

homeTeam/awayTeam

Data

Type

Example

Description

score

Data	Type	Example	Description
set1	INT	1	The 1st set score of the match for the players
set2	INT	0	The 2nd set score of the match for the players
set3	INT	1	The 3rd set score of the match for the players
set4	INT	1	The 4th set score of the match for the players
set5	INT	1	The 5th set score of the match for the players
set6	INT	1	The 6th set score of the match for the players
set7	INT	1	The 7th set score of the match for the players
current	INT	3	The current score of the match(live and post) for the players

knownName

STR

Nikolai Zhurba

The known name of the player

name

STR

Nikolai

The name of the player

surName

STR

Zhurba

The surname of the player

INT

1064

The id of the player

country

Data	Type	Example	Description
name	STR	Canada	The full name of the player's country
shortName	STR	CAN	The short name of the player's country
id	INT	24	The ID of the player's country

gender

Data	Type	Example	Description
name	STR	Women	The name of the player's gender
id	INT	2	The ID of the player's gender

status

Data	Type	Example	Description
name	STR	Full Time	The name of the status
shortName	STR	FT	The short name of the status
id	INT	5	The id of the status

tournament

Data

Type

Example

Description

name

STR

ASB Classic WTA

The name of the tournament

shortName

STR

ASB

The short name of the tournament

INT

The id of the tournament

courtType

Data	Type	Example	Description
isGrassCourt	BLN	true	Whether the tournament's court type is grass or not
isClayCourt	BLN	true	Whether the tournament's court type is clay or not
isHardCourt	BLN	true	Whether the tournament's court type is hard or not

type

Data	Type	Example	Description
isTournamentType	BLN	true	Whether the tournament's type is tournament or not
isGrandSlamType	BLN	true	Whether the tournament's type is Grand Slam or not
isChallengeType	BLN	true	Whether the tournament's type is Challenge or not

participantType

Data	Type	Example	Description
isSingles	BLN	true	Whether the tournament is the singles tournament or not
isDoubles	BLN	true	Whether the tournament is the doubles tournament or not

gender

Data	Type	Example	Description
id	INT	2	The gender id of the tournament
name	STR	women	The gender name of the tournament

stage

Data	Type	Example	Description
name	STR	Round 1	The name of the stage
shortName	STR	R1	The short name of the stage
id	INT	14630	The id of the stage

round

Data	Type	Example	Description
name	STR	Single Game	The name of the round
shortName	STR	SG	The short name of the round
id	INT	209	The id of the round

Tennis API Tech Docs

Tech Docs Index

Documentation+

Widgets+

Lookups+

Global API+

Soccer API+

Basketball API+

Football API+

Baseball API+

Ice Hockey API+

Volleyball API+

Handball API+

Table Tennis API+

Tennis API+

Tennis API Match List: All

Tennis Match List: All Request URL

References / Dependencies

Call Rate / Interval

± 7 days Match Period

Request Headers

Request Parameters

Response Output

Response Output Definitions

match

homeTeam/awayTeam

score

country

gender

status

tournament

courtType

type

participantType

gender

stage

round