Table tennis fixtures API
FixturesUpcoming matches by date.
This lists what is coming, with start times in UTC and the ids that carry on into results once played. It comes with the Table tennis plan.
Try it
Your key stays in this browser and is filled in on every docs page.
200 OK2182 ms2 rows shownReal answer from 2026-11-03, trimmed
{
"data": [
{
"id": "tt_vf1pkfwr90",
"event": {
"id": "tt_qhdn2gmfkd",
"name": "Champions Frankfurt 2026"
},
"date": "2026-11-03",
"start_time": "2026-11-03T11:00:00Z",
"discipline": "WS",
"age_group": null,
"para_class": null,
"round": "round_of_32",
"round_name": "Round of 32",
"rubber": null,
"status": "finished",
"best_of": 5,
"points_per_game": 11,
"win_by": 2,
"utc_offset_min": 60,
"sides": [
{
"side": "a",
"name": "Polcanova Sofia",
"country": "AUT",
"players": [
{
"id": "tt_9ephymbdxw",
"name": "Polcanova Sofia",
"country": "AUT"
}
]
},
{
"side": "b",
"name": "Harimoto Miwa",
"country": "JPN",
"players": [
{
"id": "tt_6qcq985bnf",
"name": "Harimoto Miwa",
"country": "JPN"
}
]
}
],
"score": {
"a": 3,
"b": 0
},
"winner": "a",
"result_note": null,
"games": [
{
"a": 11,
"b": 3
},
{
"a": 11,
"b": 1
},
{
"a": 11,
"b": 0
}
],
"duration_s": 457,
"table": 1,
"started_at": "2026-11-03T01:21:29Z",
"timeouts": {
"a": 1,
"b": 1
},
"cards": {
"a": [
"yellow",
"yellow-red",
"yellow-red 2"
],
"b": [
"yellow",
"yellow-red",
"yellow-red 2"
]
},
"video_review": false,
"challenges_each": 99,
"serving": null
},
{
"id": "tt_73xb5atvfw",
"event": {
"id": "tt_qhdn2gmfkd",
"name": "Champions Frankfurt 2026"
},
"date": "2026-11-03",
"start_time": "2026-11-03T11:35:00Z",
"discipline": "MS",
"age_group": null,
"para_class": null,
"round": "round_of_32",
"round_name": "Round of 32",
"rubber": null,
"status": "finished",
"best_of": 5,
"points_per_game": 11,
"win_by": 2,
"utc_offset_min": 60,
"sides": [
{
"side": "a",
"name": "Zhou Qihao",
"country": "CHN",
"players": [
{
"id": "tt_zywf2zafdh",
"name": "Zhou Qihao",
"country": "CHN"
}
]
},
{
"side": "b",
"name": "Poret Thibault",
"country": "FRA",
"players": [
{
"id": "tt_9f42fghsg7",
"name": "Poret Thibault",
"country": "FRA"
}
]
}
],
"score": {
"a": 0,
"b": 3
},
"winner": "b",
"result_note": null,
"games": [
{
"a": 0,
"b": 11
},
{
"a": 0,
"b": 11
},
{
"a": 0,
"b": 11
}
],
"duration_s": 69532,
"table": 1,
"started_at": "2026-11-03T01:30:58Z",
"timeouts": {
"a": 0,
"b": 0
},
"cards": {
"a": [],
"b": []
},
"video_review": false,
"challenges_each": 99,
"serving": null
}
],
"meta": {
"sport": "table-tennis",
"endpoint": "/fixtures",
"count": 13,
"page": 1,
"per_page": 50,
"total": 13,
"total_pages": 1,
"next_cursor": null,
"next_page": null,
"prev_page": null,
"cached": false,
"age_seconds": 0
}
}No key yet? Get a free key: it reads yesterday for every sport and is filled in here once made.
Parameters
Query values this call takes. Anything else is refused with bad_param and the list it accepts.
| Name | Type | What it does | |
|---|---|---|---|
| date | date | optional | One day, written YYYY-MM-DD. Leave it out for the default day. The free key reads yesterday only. |
| competition | id | optional | Only this competition, by its id from Competitions. |
| page | integer | optional | Which page of rows, from 1. |
| per_page | integer | optional | Rows per page, up to 100 on most lists. |
Returns
Each row of data, from a real answer. Every id is ours and opens its own endpoint.
| Field | Type | What it holds |
|---|---|---|
| id | id | Our id for this record |
| event | object | Event |
| date | date | The day, YYYY-MM-DD |
| start_time | datetime | Start time |
| discipline | string | The discipline |
| age_group | null | Age group |
| para_class | null | Para class |
| round | string | The round |
| round_name | string | Round name |
| rubber | null | Rubber |
| status | string | Its state: scheduled, live, finished or similar |
| best_of | integer | Best of |
| points_per_game | integer | Points per game |
| win_by | integer | Win by |
| utc_offset_min | integer | Utc offset in metresin |
| sides | list | Sides |
| score | object | The score |
| winner | string | Who won |
| result_note | null | Result note |
| games | list | Each game |
| duration_s | integer | Length in seconds |
| table | integer | Table |
| started_at | datetime | Started at |
| timeouts | object | Timeouts |
| cards | object | Cards |
| video_review | boolean | Video review |
| challenges_each | integer | Challenges each |
| serving | null | Serving |
| meta | What it holds |
|---|---|
| sport, endpoint | What you asked |
| count | Rows in this answer |
| page, per_page, total, next_cursor | Where you are in a paged list, when it is paged |
| as_of | When the data was built |
| cached, age_seconds | Whether this is a stored copy, and its age |
| access | On the free key: what it reads, and the plan that opens the rest |
Errors
Codes this call can give. Each is explained in Errors.
| Status | Code | When |
|---|---|---|
| 401 | no_key | No key sent, or not in a form we read |
| 401 | bad_key | A key we do not know |
| 403 | plan | The free key, or a sport you do not hold |
| 422 | bad_param | A value this call does not take |
| 429 | rate | Over the calls a minute for your plan |
| 503 | upstream | The data is not answering; retry after Retry-After |
Fixtures comes with the Table tennis plan, $19 a month, with every date held and 250,000 calls a month.
Add Table tennis