Table Tennis API Tech Docs

Question & Answers

Table Tennis API Match List: Live

Provides the daily live match list in active season.

Table Tennis Match List: Live 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": 11, "set2": 6, "set3": 10, "set4": 6, "current": 1 }, "player1": { "gender": { "name": "Men", "id": 1 }, "country": { "name": "Russia", "shortName": "RUS", "id": 23 }, "knownName": "Andrey Potapkov", "name": "Andrey", "surName": "Potapkov", "middleName": "", "id": 1099 } }, "awayTeam": { "scores": { "set1": 8, "set2": 11, "set3": 12, "set4": 5, "current": 2 }, "player1": { "gender": { "name": "Men", "id": 1 }, "country": { "name": "Russia", "shortName": "RUS", "id": 23 }, "knownName": "Ivan Afanasev", "name": "Ivan", "surName": "Afanasev", "middleName": "", "id": 1206 } }, "status": { "name": "4th Set", "shortName": "4S", "id": 19 }, "date": "28/01/2021 08:30:00", "id": 62804, "tournament": { "participantType": { "isSingles": true }, "gender": { "name": "Men", "id": 1 }, "name": "Liga Pro Erkekler", "shortName": "ELP", "id": 11 }, "stage": { "name": "16 Ocak - 31 Ocak Maçlar", "shortName": "16O31O", "id": 107 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "scores": { "set1": 3, "set2": 9, "current": 0 }, "player1": { "gender": { "name": "Men", "id": 1 }, "country": { "name": "Russia", "shortName": "RUS", "id": 23 }, "knownName": "Sergey Ogay", "name": "Sergey", "surName": "Ogay", "middleName": "", "id": 779 } }, "awayTeam": { "scores": { "set1": 11, "set2": 10, "current": 1 }, "player1": { "gender": { "name": "Men", "id": 1 }, "country": { "name": "Russia", "shortName": "RUS", "id": 23 }, "knownName": "Dmitriy Petrov", "name": "Dmitriy", "surName": "Petrov", "middleName": "", "id": 1418 } }, "status": { "name": "2nd Set", "shortName": "2S", "id": 17 }, "date": "28/01/2021 08:45:00", "id": 62806, "tournament": { "participantType": { "isSingles": true }, "gender": { "name": "Men", "id": 1 }, "name": "Liga Pro Erkekler", "shortName": "ELP", "id": 11 }, "stage": { "name": "16 Ocak - 31 Ocak Maçlar", "shortName": "16O31O", "id": 107 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } } ]

sample 1

Response Output Definitions

match

Data

Type

Example

Description

date

DATE/STR

28/01/2021 08:30:00

The starting date of the match, includes also time

INT

62804

The id of the match

homeTeam/awayTeam

Data

Type

Example

Description

knownName

STR

Andrey Potapkov

The known name of the player

name

STR

Andrey

The name of the player

surName

STR

Potapkov

The surname of the player

middleName

STR

The middle name of the player

INT

1099

The id of the player

scores

Data	Type	Example	Description
set1	INT	11	The 1st set score of the match for the players
set2	INT	6	The 2nd set score of the match for the players
set3	INT	10	The 3rd set score of the match for the players
set4	INT	6	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

country

Data	Type	Example	Description
name	STR	Russia	The name of the player's country
shortName	STR	RUS	The short name of the player's country
id	INT	23	The id of the player's country

gender

Data	Type	Example	Description
name	STR	Men	The name of the player's gender
id	INT	1	The id of the player's gender

status

Data	Type	Example	Description
name	STR	4th Set	The name of the status
shortName	STR	4S	The short name of the status
id	INT	19	The id of the status

tournament

Data

Type

Example

Description

name

STR

Liga Pro Men

The name of the tournament

shortName

STR

LPM

The short name of the tournament

INT

The id of the tournament

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	1	The gender id of the tournament
name	STR	men	The gender name of the tournament

stage

Data	Type	Example	Description
name	STR	16th of January-31st of January Matches	The name of the stage
shortName	STR	16O31O	The short name of the stage
id	INT	107	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

Table 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

Table Tennis API Match List: Live

Table Tennis Match List: Live Request URL

References / Dependencies

Call Rate / Interval

± 7 days Match Period

Request Headers

Request Parameters

Response Output

Response Output Definitions

match

homeTeam/awayTeam

scores

country

gender

status

tournament

participantType

gender

stage

round