{
    "info": {
        "name": "Table Tennis API",
        "description": "Every call of the Table Tennis API, ready to run. Set the collection variable TT_KEY to your key. Documentation: https://tabletennisapi.com/documentation",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "auth": {
        "type": "bearer",
        "bearer": [
            {
                "key": "token",
                "value": "{{TT_KEY}}",
                "type": "string"
            }
        ]
    },
    "variable": [
        {
            "key": "baseUrl",
            "value": "https://api.tabletennisapi.com",
            "type": "string"
        },
        {
            "key": "TT_KEY",
            "value": "",
            "type": "string"
        }
    ],
    "item": [
        {
            "name": "Account",
            "item": [
                {
                    "name": "GET /v1/usage",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/usage",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "usage"
                            ]
                        },
                        "description": "Your plan, calls today, limits and the dates your plan reads. Not counted against your allowance. Plans: Free key, Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/usage"
                    }
                }
            ]
        },
        {
            "name": "Events",
            "item": [
                {
                    "name": "GET /v1/events",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/events",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "events"
                            ],
                            "query": [
                                {
                                    "key": "from",
                                    "value": "",
                                    "description": "Events ending on or after this day (YYYY-MM-DD)",
                                    "disabled": true
                                },
                                {
                                    "key": "to",
                                    "value": "",
                                    "description": "Events starting on or before this day (YYYY-MM-DD)",
                                    "disabled": true
                                },
                                {
                                    "key": "q",
                                    "value": "",
                                    "description": "Words in the event name, such as \"Champions\" or \"Doha\"",
                                    "disabled": true
                                },
                                {
                                    "key": "country",
                                    "value": "",
                                    "description": "Host country, three letters (CHN, QAT)",
                                    "disabled": true
                                },
                                {
                                    "key": "tier",
                                    "value": "",
                                    "description": "1 the top senior events, 2 other senior events, 3 feeders, 4 youth, 5 other",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Rows a page, 1 to 200",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "Page number",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "Events: past, running and scheduled, newest first. Plans: Free key, Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/events"
                    }
                },
                {
                    "name": "GET /v1/events/{id}",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/events/ev_w5hw10am",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "events",
                                "ev_w5hw10am"
                            ]
                        },
                        "description": "One event: name, dates, venue, and its disciplines with match counts. Plans: Free key, Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/event"
                    }
                },
                {
                    "name": "GET /v1/events/{id}/matches",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/events/ev_w5hw10am/matches",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "events",
                                "ev_w5hw10am",
                                "matches"
                            ],
                            "query": [
                                {
                                    "key": "discipline",
                                    "value": "",
                                    "description": "MS, WS, MD, WD, XD; teams MT, WT, XT",
                                    "disabled": true
                                },
                                {
                                    "key": "age_group",
                                    "value": "",
                                    "description": "Youth age group: U11, U13, U15, U17, U19. \"senior\" for seniors only",
                                    "disabled": true
                                },
                                {
                                    "key": "para_class",
                                    "value": "",
                                    "description": "Para sport class, such as MS6",
                                    "disabled": true
                                },
                                {
                                    "key": "round",
                                    "value": "",
                                    "description": "Round: final, semi_final, quarter_final, round_of_16 ... round_of_128, group, qualifying_1 to qualifying_4, qualifying_knockout or bronze",
                                    "disabled": true
                                },
                                {
                                    "key": "status",
                                    "value": "",
                                    "description": "finished, live, scheduled or unconfirmed (played, no official result)",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Rows a page, 1 to 200",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "Page number",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "An event's matches, in order of play. Plans: Free key, Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/event-matches"
                    }
                }
            ]
        },
        {
            "name": "Matches",
            "item": [
                {
                    "name": "GET /v1/matches",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/matches",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "matches"
                            ],
                            "query": [
                                {
                                    "key": "date",
                                    "value": "",
                                    "description": "One day (YYYY-MM-DD), the local day of play. Default: today",
                                    "disabled": true
                                },
                                {
                                    "key": "from",
                                    "value": "",
                                    "description": "First day, with to",
                                    "disabled": true
                                },
                                {
                                    "key": "to",
                                    "value": "",
                                    "description": "Last day, with from (at most 31 days)",
                                    "disabled": true
                                },
                                {
                                    "key": "discipline",
                                    "value": "",
                                    "description": "MS, WS, MD, WD, XD; teams MT, WT, XT",
                                    "disabled": true
                                },
                                {
                                    "key": "age_group",
                                    "value": "",
                                    "description": "Youth age group: U11 to U19. \"senior\" for seniors only",
                                    "disabled": true
                                },
                                {
                                    "key": "tier",
                                    "value": "",
                                    "description": "Event tier, 1 to 5",
                                    "disabled": true
                                },
                                {
                                    "key": "status",
                                    "value": "",
                                    "description": "finished, live, scheduled or unconfirmed (played, no official result)",
                                    "disabled": true
                                },
                                {
                                    "key": "country",
                                    "value": "",
                                    "description": "Matches with a player from this country (three letters)",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Rows a page, 1 to 200",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "Page number",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "Matches on a day or across dates, every event. Plans: Free key, Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/matches"
                    }
                },
                {
                    "name": "GET /v1/matches/{id}",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/matches/mt_fs5ttbe2",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "matches",
                                "mt_fs5ttbe2"
                            ]
                        },
                        "description": "One match: players, score, every game, length, table, format, real start, timeouts and cards. Plans: Free key, Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/match"
                    }
                },
                {
                    "name": "GET /v1/matches/{id}/points",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/matches/mt_fs5ttbe2/points",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "matches",
                                "mt_fs5ttbe2",
                                "points"
                            ]
                        },
                        "description": "Point by point: every score in every game as our live tracking saw it, about every 10 seconds, with who served. For matches followed live from October 2026. Plans: Free key, Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/match-points"
                    }
                },
                {
                    "name": "GET /v1/live",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/live",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "live"
                            ],
                            "query": [
                                {
                                    "key": "discipline",
                                    "value": "",
                                    "description": "MS, WS, MD, WD, XD; teams MT, WT, XT",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "Matches being played now, with the game in progress. Refreshed about every 10 seconds. Plans: Live, Complete. https://tabletennisapi.com/documentation/endpoints/live"
                    }
                },
                {
                    "name": "GET /v1/results/yesterday",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/results/yesterday",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "results",
                                "yesterday"
                            ],
                            "query": [
                                {
                                    "key": "discipline",
                                    "value": "",
                                    "description": "MS, WS, MD, WD, XD; teams MT, WT, XT",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Rows a page, 1 to 200",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "Page number",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "Yesterday's finished matches, every event. On every plan. Plans: Free key, Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/results-yesterday"
                    }
                }
            ]
        },
        {
            "name": "Players",
            "item": [
                {
                    "name": "GET /v1/players",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/players",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "players"
                            ],
                            "query": [
                                {
                                    "key": "q",
                                    "value": "",
                                    "description": "Part of the name, at least 2 letters",
                                    "disabled": true
                                },
                                {
                                    "key": "country",
                                    "value": "",
                                    "description": "Three letters (CHN, JPN)",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Rows a page, 1 to 200",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "Page number",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "Find players by name or country. Plans: Free key, Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/players"
                    }
                },
                {
                    "name": "GET /v1/players/{id}",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/players/pl_51t63nz3",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "players",
                                "pl_51t63nz3"
                            ]
                        },
                        "description": "One player: name, country and their record by discipline. Plans: Free key, Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/player"
                    }
                },
                {
                    "name": "GET /v1/players/{id}/matches",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/players/pl_51t63nz3/matches",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "players",
                                "pl_51t63nz3",
                                "matches"
                            ],
                            "query": [
                                {
                                    "key": "from",
                                    "value": "",
                                    "description": "First day (YYYY-MM-DD)",
                                    "disabled": true
                                },
                                {
                                    "key": "to",
                                    "value": "",
                                    "description": "Last day (YYYY-MM-DD)",
                                    "disabled": true
                                },
                                {
                                    "key": "discipline",
                                    "value": "",
                                    "description": "MS, WS, MD, WD, XD; teams MT, WT, XT",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Rows a page, 1 to 200",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "Page number",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "A player's matches, newest first, singles and doubles. Plans: Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/player-matches"
                    }
                },
                {
                    "name": "GET /v1/h2h/{a}/{b}",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/h2h/pl_51t63nz3/pl_yp1ww51h",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "h2h",
                                "pl_51t63nz3",
                                "pl_yp1ww51h"
                            ],
                            "query": [
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Rows a page, 1 to 200",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "Page number",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "Two players against each other: wins, games, and every meeting. Plans: Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/h2h"
                    }
                }
            ]
        },
        {
            "name": "Rankings",
            "item": [
                {
                    "name": "GET /v1/rankings",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/rankings",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "rankings"
                            ],
                            "query": [
                                {
                                    "key": "discipline",
                                    "value": "",
                                    "description": "MS, WS, MD, WD or XD",
                                    "disabled": true
                                },
                                {
                                    "key": "doubles",
                                    "value": "",
                                    "description": "For MD, WD and XD: pair (pairs ranked together) or player (each player ranked on their own doubles results)",
                                    "disabled": true
                                },
                                {
                                    "key": "list",
                                    "value": "",
                                    "description": "senior or youth",
                                    "disabled": true
                                },
                                {
                                    "key": "week",
                                    "value": "",
                                    "description": "A past week, such as 2026-41 (year and week). Weeks are held from the first week we read on",
                                    "disabled": true
                                },
                                {
                                    "key": "country",
                                    "value": "",
                                    "description": "Only players from this country (three letters); keeps their world rank",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "World rankings: the top 100 of a list for a week, with points and movement. The latest week unless you ask for one. Plans: Free key, Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/rankings"
                    }
                },
                {
                    "name": "GET /v1/players/{id}/rankings",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{baseUrl}}/v1/players/pl_51t63nz3/rankings",
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "path": [
                                "v1",
                                "players",
                                "pl_51t63nz3",
                                "rankings"
                            ],
                            "query": [
                                {
                                    "key": "discipline",
                                    "value": "",
                                    "description": "MS, WS, MD, WD or XD",
                                    "disabled": true
                                },
                                {
                                    "key": "doubles",
                                    "value": "",
                                    "description": "For MD, WD and XD: pair or player",
                                    "disabled": true
                                },
                                {
                                    "key": "from",
                                    "value": "",
                                    "description": "Weeks published on or after this day (YYYY-MM-DD)",
                                    "disabled": true
                                },
                                {
                                    "key": "to",
                                    "value": "",
                                    "description": "Weeks published on or before this day (YYYY-MM-DD)",
                                    "disabled": true
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Rows a page, 1 to 200",
                                    "disabled": true
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "Page number",
                                    "disabled": true
                                }
                            ]
                        },
                        "description": "A player's world ranking week by week, on every list they are in, newest first. Plans: Live, Archive, Complete. https://tabletennisapi.com/documentation/endpoints/player-rankings"
                    }
                }
            ]
        }
    ]
}