/v1/players/{id}

One player: name, country and their record by discipline.

GEThttps://api.tabletennisapi.com/v1/players/{id}

Plans:Free keyLiveArchiveComplete

Parameters

Name	In	Type	Required	What it does	Example
`id`	path	id	required	The player id, as returned by any list	`pl_51t63nz3`

Run it live

GET /v1/players/{id}A real call to the API, from your browser

Your key stays in this page: it is sent only to api.tabletennisapi.com and never stored. Left empty, the call runs on a free key with its dates and fields, 20 calls a minute.

GEThttps://api.tabletennisapi.com/v1/players/{id}

Not run yet

Press Run it to see the answer here.

Response

A real answer from the data. Every field is described in the manual.

200 OKapplication/json

{
    "data": {
        "id": "pl_51t63nz3",
        "name": "Harimoto Miwa",
        "country": "JPN",
        "born": "2008-06-16",
        "hand": "right",
        "height_cm": null,
        "record": [
            {
                "discipline": "WS",
                "played": 120,
                "won": 97,
                "lost": 23,
                "first": "2025-01-09",
                "last": "2026-10-10"
            },
            {
                "discipline": "WD",
                "played": 60,
                "won": 53,
                "lost": 7,
                "first": "2025-01-09",
                "last": "2026-10-10"
            },
            {
                "discipline": "XD",
                "played": 41,
                "won": 27,
                "lost": 14,
                "first": "2025-01-07",
                "last": "2026-10-08"
            }
        ],
        "world_ranks": [
            {
                "discipline": "WS",
                "doubles": null,
                "list": "senior",
                "rank": 3,
                "points": 7009,
                "week": "2026-43"
            },
            {
                "discipline": "WD",
                "doubles": "pair",
                "list": "senior",
                "rank": 1,
                "points": 7750,
                "week": "2026-43"
            },
            {
                "discipline": "WD",
                "doubles": "pair",
                "list": "senior",
                "rank": 51,
                "points": 400,
                "week": "2026-43"
            },
            {
                "discipline": "WD",
                "doubles": "player",
                "list": "senior",
                "rank": 2,
                "points": 8155,
                "week": "2026-43"
            },
            {
                "discipline": "XD",
                "doubles": "pair",
                "list": "senior",
                "rank": 9,
                "points": 2315,
                "week": "2026-43"
            },
            {
                "discipline": "XD",
                "doubles": "player",
                "list": "senior",
                "rank": 20,
                "points": 2315,
                "week": "2026-43"
            },
            {
                "discipline": "WS",
                "doubles": null,
                "list": "youth",
                "rank": 1,
                "points": 40945,
                "week": "2026-43"
            },
            {
                "discipline": "WD",
                "doubles": "player",
                "list": "youth",
                "rank": 1,
                "points": 40775,
                "week": "2026-43"
            },
            {
                "discipline": "XD",
                "doubles": "player",
                "list": "youth",
                "rank": 2,
                "points": 11575,
                "week": "2026-43"
            }
        ]
    },
    "meta": []
}

Example

curl

curl https://api.tabletennisapi.com/v1/players/pl_51t63nz3 \
  -H "Authorization: Bearer $TT_KEY"

Python

import os, requests
res = requests.get("https://api.tabletennisapi.com/v1/players/pl_51t63nz3",
    headers={"Authorization": "Bearer " + os.environ["TT_KEY"]}).json()

Answers come back as data and meta; errors as error. See Errors and Pagination.