> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Table Tennis V2 API Overview

> Enhanced table tennis API with 94 endpoints: live scores, player stats, point-by-point data, and tournament brackets

## Base URL

```
https://api.sportsapipro.com/v2/table-tennis
```

## Authentication

Same as all other sports — pass your API key in the `x-api-key` header:

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/table-tennis/live
```

## Table Tennis-Specific Notes

* **Best of 5 or 7 games** — each game to 11 points (deuce at 10-10, must win by 2)
* **Score fields** — `period1` through `period7` represent individual game scores
* **Point-by-point** — available for live matches via `/match/:id/point-by-point`
* **Events** — MS/WS (singles), MD/WD (doubles), XD (mixed doubles)
* **Player traits** — playing hand (R/L), grip style (shakehand/penhold)
* **High volume** — 2,283+ matches per day — use pagination and filters
* **9 categories** globally

## Test IDs

| Entity     | Name                  | ID       |
| ---------- | --------------------- | -------- |
| Tournament | WTT Feeder Otocec, MS | 21417    |
| Season     | 2026                  | 90349    |
| Player     | Hamada K.             | 456267   |
| Player     | Bobocica M.           | 24885    |
| Match      | Hamada vs Bobocica    | 15704524 |

## Endpoint Summary

| Category           | Count  |
| ------------------ | ------ |
| Live & Schedule    | 7      |
| Search & Discovery | 7      |
| Tournament         | 19     |
| Match              | 25     |
| Team               | 11     |
| Player             | 17     |
| Referee & Venue    | 8      |
| **Total**          | **94** |

## Example Requests

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    https://api.sportsapipro.com/v2/table-tennis/live
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.sportsapipro.com/v2/table-tennis/live',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.sportsapipro.com/v2/table-tennis/live',
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

## UI Design Ideas

* **Score display**: Show game-by-game scores (e.g., 3-1 with 11-8, 7-11, 11-5, 11-9)
* **Match format**: Best of 5 games (most events), best of 7 (World Championships finals)
* **Games to 11 points** (must win by 2), deuce at 10-10
* **Point-by-point**: Available for live matches — great for real-time tracking
* **Player profile**: Nationality, world ranking, playing hand (R/L), grip style (shakehand/penhold)
* **High volume**: 2,283+ matches per day — use pagination and filters

## Sport Comparison — Table Tennis vs Tennis

| Feature        | Table Tennis                                 | Tennis                           |
| -------------- | -------------------------------------------- | -------------------------------- |
| Scoring        | Games to 11 (deuce at 10-10), best of 5 or 7 | Sets → Games → Points (15-30-40) |
| Score fields   | period1-period7 (games)                      | period1-period5 (sets)           |
| Match format   | Best of 5 (most) or 7 (finals)               | Best of 3 or 5 sets              |
| Point-by-point | ✅ Available                                  | ✅ Available                      |
| Key stats      | Service points, receive points, rallies      | Aces, double faults              |
| Doubles        | ✅ (Mixed, Men's, Women's)                    | ✅                                |
| Rankings       | ITTF/WTT World Rankings                      | ATP/WTA                          |
| Daily volume   | 2,283+ matches/day                           | 200-400 matches/day              |