Skip to content

Table tennis data reference

← All sports

Generated from GET /v2/sports/46. Not hand-maintained - if the API adds a status or renames a statistic, this page follows on the next build.

Sport id
46
Participants
2
Match clock
no
Incident positions
no

Statuses 28

Every value event.status_id can take for this sport. Map onto this list rather than parsing status_type: ids are stable, labels are localized, and postponed matches keep status_type: scheduled.

idNameShortTypeNotes
1Not startedSched.scheduledclock stoppedset by incident 427
6Start delayedDelay.scheduledclock stoppedset by incident 438
5PostponedPost.scheduledclock stoppedset by incident 440TRAP: status_type is scheduled, exactly like a normal upcoming match. A postponed match is indistinguishable from a scheduled one unless you look at status_id. Never branch only on status_type.
1341st set1st setliveclock running
155Break after 1st set1st set breaklivebreakclock stopped
652nd set2nd setliveclock running
156Break after 2nd set2nd set breaklivebreakclock stopped
1353rd set3rd setliveclock running
157Break after 3rd set3rd set breaklivebreakclock stopped
1364th set4th setliveclock running
158Break after 4th set4th set breaklivebreakclock stopped
1375th set5th setliveclock running
159Break after 5th set5th set breaklivebreakclock stopped
1626th set6th setlive
160Break after 6th set6th set breaklive
1637th set7th setlive
161Break after 7th set7th set breaklive
2268th set8th setlive
232Break after 8th set8th set breaklive
2279th set9th setlive
233Break after 9th set9th set breaklive
2InterruptedInterr.interruptedclock stoppedset by incident 441Play stopped and may resume. Incident 1001 (Match resumed) brings it back. Distinct from Abandoned (7), which may never resume.
7AbandonedAbd.interruptedclock stoppedset by incident 442Play stopped and may never resume. Same status_type as Interrupted (2), so tell them apart by status_id.
11FinishedFin.finishedclock stoppedset by incident 437One of FIVE terminal statuses (11, 12, 13, 14, 140). Treat every status_type: finished as terminal - checking for 11 alone misses matches decided in extra time, on penalties or in overtime.
12Finished awarded winAWfinishedclock stoppedset by incident 436Walkover: the result was awarded, not played out. Statistics and the timeline may be empty or not reflect play.
76RetiredRet.finished
3CancelledCanc.cancelledclock stoppedset by incident 439
152To finishTo fin.scheduledclock stoppedset by incident 451TRAP: status_type is scheduled, but the match already started and was stopped - it is waiting to be finished on another date. Do not present it as an upcoming fixture.

Results 21

Entries that can appear in participants[].results[], keyed by id. There is no score field - you select the result you need.

idNameCodeTypeData type
411Winnerwinnerteambinary
412Progressprogressteambinary
2Resultresultteaminteger
43First setfirst_setteaminteger
43First setfirst_setpersoninteger
44Second setsecond_setteaminteger
44Second setsecond_setpersoninteger
45Third setthird_setteaminteger
45Third setthird_setpersoninteger
46Fourth setfourth_setteaminteger
46Fourth setfourth_setpersoninteger
47Fifth setfifth_setteaminteger
47Fifth setfifth_setpersoninteger
417Sixth setsixth_setteaminteger
417Sixth setsixth_setpersoninteger
418Seventh setseventh_setteaminteger
418Seventh setseventh_setpersoninteger
494Eighth seteighth_setteaminteger
494Eighth seteighth_setpersoninteger
495Ninth setninth_setteaminteger
495Ninth setninth_setpersoninteger

Event details 11

Per-match metadata in the event's details, with the input type and allowed values.

idNameCodeInputData type
125Sets numbersets_number_table_tennisselect-
126Scoring systemscoring_system_table_tennisselect-
1First set start datefirst_set_start_datedatetime-
2Second set start datesecond_set_start_datedatetime-
3Third set start datethird_set_start_datedatetime-
4Fourth set start datefourth_set_start_datedatetime-
5Fifth set start datefifth_set_start_datedatetime-
62Sixth set start datesixth_set_start_datedatetime-
63Seventh set start dateseventh_set_start_datedatetime-
118Eighth set start dateeighth_set_start_datedatetime-
119Ninth set start dateninth_set_start_datedatetime-

Incidents 82

Incident types that can appear in this sport's events_incidents. category: emergency marks operational notices, not match events - never render them on a timeline.

idNameCodeTypeTraderCategoryNotes
1501In progressin-progresseventnostandard
2846The match will not be coveredthe-match-will-not-be-coveredeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will not be covered at all. The attribute gives the reason. Nothing further will arrive.
Other: Scout's technical issues, Change of venue, Change of match date, Problems with TV transmission source
15021st set started1st-set-startedeventyesstandard
2847Problems with the source of the broadcastproblems-with-the-source-of-the-broadcaseventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The broadcast source has a problem. Paired with 2848 when it is solved.
15032nd set started2nd-set-startedeventyesstandard
2848Problem with the source of the broadcast has been solvedproblem-with-the-source-of-the-broadcasteventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The broadcast source problem is solved.
15043rd set started3rd-set-startedeventyesstandard
2849Change of coverage from venue to TVchange-of-coverage-from-venue-to-tveventyesemergencyemergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Before kick-off (group: prematch): moved from venue to TV.
15054th set started4th-set-startedeventyesstandard
2850Change of coverage from TV to venuechange-of-coverage-from-tv-to-venueeventyesemergencyemergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Before kick-off (group: prematch): moved from TV to venue.
15065th set started5th-set-startedeventyesstandard
2851Change of coverage latencychange-of-coverage-latencyeventyesemergencyemergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Latency of the coverage changed. Relevant if you gate markets on feed delay.
Other: from 3-6 to 7-15, from 7-15 to 3-6
15076th set started6th-set-startedeventyesstandard
2852Scouting coverage can start with a delay ofscouting-coverage-can-start-with-a-delayeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Scouting coverage will start late. The attribute gives the size (under 3, 3-5 or 5-10 minutes).
Other: < 3min, 3-5 min, 5-10 min
15087th set started7th-set-startedeventyesstandard
2853Expected delay in the start of the matchexpected-delay-in-the-start-of-the-matcheventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will start late. The attribute gives the reason - a team arriving late, problems in the stands and so on.
Other: Delayed arrival of a team, Problems in the stands, Referee problems, Infrastructure problems, Weather conditions
2854Team line-ups will not be availableteam-line-ups-will-not-be-availableeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Line-ups will not be available for this match. Do not wait for lineups[] to fill.
15098th set started8th-set-startedeventyesstandard
2855Source of the coverage is delayedsource-of-the-coverage-is-delayedeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The coverage source is delayed. The attribute gives the size of the delay (about 5 to 20 seconds).
Other: ~5sec, ~10sec, ~15sec, ~20sec, ~25sec, ~30sec, >30sec
15109th set started9th-set-startedeventyesstandard
2856The current part of the game has started with a delaythe-current-part-of-the-game-has-startedeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The current period started late.
1511Change sideschange-sideseventnostandard
2857Verification of result in progressverification-of-result-in-progresseventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
1512Set Breakset-breakeventyesstandard
2858Verification of result completed and correctverification-of-result-completed-and-coreventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of the result finished. Values are confirmed.
2859Verification of key statistics is in progressverification-of-key-statistics-is-in-proeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2860Verification of key statistics completed and correctverification-of-key-statistics-completedeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of key statistics finished. Values are confirmed.
2861Verification of game clock is in progressverification-of-game-clock-is-in-progreseventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2862Verification of game clock completed and correctverification-of-game-clock-completed-andeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of the game clock finished. Values are confirmed.
2863Match coverage interrupted due to technical issuesmatch-coverage-interrupted-due-to-technieventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage stopped because of technical issues. 2864 or 2865 says whether it comes back.
2864Match coverage will continuematch-coverage-will-continueeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage will continue after the interruption.
2865Match coverage will not continuematch-coverage-will-not-continueeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage will NOT continue. Expect no further incidents for this match.
2866The match is abandonedthe-match-is-abandonedeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match was abandoned. The attribute gives the reason.
Other: Problems in the stands, Referee problems, Infrastructure problems, Serious player injury, Weather conditions
1513Abandonedabandonedeventyesstandard
2867Waiting for official decision regarding match resumptionwaiting-for-official-decision-regarding-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Waiting for an official decision on whether the match resumes. 2868 or 2869 follows.
1514Cancelledcancelledeventyesstandard
2868Match will resume shortlymatch-will-resume-shortlyeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match resumes shortly.
1515Finished regular timefinished-regular-timeeventyesstandard
2869Match will not resumematch-will-not-resumeeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will not resume.
1516Interruptedinterruptedeventyesstandard
2870Expected delay in the start of the next part of the gameexpected-delay-in-the-start-of-the-next-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The next period will start late. The attribute gives the reason.
Other: Problems in the stands, Referee problems, Infrastructure problems, Weather conditions
1517Postponedpostponedeventyesstandard
2871Change of coverage from venue to TVchange-of-coverage-from-venue-to-tv-liveeventyesemergencyemergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. During play (group: live): moved from venue to TV.
1518Retiredretiredeventyesstandard
2872Change of coverage from TV to venuechange-of-coverage-from-tv-to-venue-liveeventyesemergencyemergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. During play (group: live): moved from TV to venue.
1519Start delayedstart-delayedeventyesstandard
2873Change of coverage latencychange-of-coverage-latency-liveeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage latency changed. The attribute gives the direction, for example from 3-6 to 7-15 seconds. Relevant if you gate markets on feed delay.
Other: from 3-6 to 7-15, from 7-15 to 3-6
1520To finishto-finisheventyesstandard
2874Expected delay in the start of the match - safety reasonsexpected-delay-in-the-start-of-the-matcheventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will start late for safety reasons.
1521Technical timeouttechnical-timeouteventyesstandard
2875Verification of key statistics is in progressverification-of-key-statistics-is-in-proeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
1522Finished awarded winfinished-awarded-wineventyesstandard
2876Verification of key statistics completed and correctverification-of-key-statistics-completedeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of key statistics, after the match finished. Values are confirmed.
2877Verification of player names for key incidents in progressverification-of-names-for-key-incidents-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2878Verification of player names for key incidents completed and correctverification-of-names-for-key-incidents-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of player names on key incidents finished. Values are confirmed.
2879Verification of result is in progressverification-of-result-is-in-progresseventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2880Verification of result completed and correctverification-of-result-completed-and-coreventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of the result, after the match finished. Values are confirmed.
2881Problems with the low latency source of the coverageproblems-with-the-low-latency-source-of-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The low-latency source has a problem. Paired with 2882.
2882Problems with the low latency source of coverage has been solvedproblems-with-the-low-latency-source-of-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The low-latency source problem is solved.
2883Player name verification is in progress - substitutionplayer-name-verification-is-in-progress-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
1000BetstartbetstarteventyesstandardmarketBetting markets may be activated.
Other: Master
1010BetstopbetstopeventyesstandardmarketAll betting markets are closed: a goal, penalty or red card looks likely, or the situation on the pitch is unclear.
Other: Master
1001Match resumedmatch-resumedeventyesstandardinformingUsed when an interrupted match resumes.
1200Technical problemstechnical-problemseventyesstandardmarketTechnical problems during coverage. Closes all match markets automatically.
1530Pointpointteamyesstandard
1531Serveserveteamnostandard
1532Service errorservice-errorteamyesstandard
1533Letletteamyesstandard
1534Unreturned serviceunreturned-serviceteamyesstandard
1535Outoutteamyesstandard
1536Net attacknet-attackteamyesstandard
1537Player errorplayer-errorteamyesstandard
1538Repeat pointrepeat-pointteamyesstandard
1539Timeouttimeoutteamnostandard
1540Medical timeoutmedical-timeoutteamyesstandard
1541Yellow cardyellow-cardteamnostandard
1542Red cardred-cardteamyesstandard
1543White cardwhite-cardteamyesstandard
1544Set ballset-ballteamnostandard
1545Set wonset-wonteamyesstandard
1546Match ballmatch-ballteamnostandard
1547Point cancelledpoint-cancelledteamyesstandard

Statistics 14

Split into team statistics (in participants[].stats) and person statistics (in sub_participants[].stats). Match by code, not by position.

Team 7

idNameCodeData type
8Yellow cardsyellow_cardsinteger
9Red cardsred_cardsinteger
510White cardswhite_cardsinteger
414Total points wonTP_woninteger
403Is server sideservicebinary_text
105Service faultsservice_faultsinteger
153Errorserrorsinteger

Person 7

idNameCodeData type
8Yellow cardsyellow_cardsinteger
9Red cardsred_cardsinteger
510White cardswhite_cardsinteger
414Total points wonTP_woninteger
403Is server sideservicebinary_text
105Service faultsservice_faultsinteger
153Errorserrorsinteger