Documentation / Endpoints / Reference and account

/v1/usage

Your plan, calls today, limits and the dates your plan reads. Not counted against your allowance.

GEThttps://api.tabletennisapi.com/v1/usage

Plans:Free keyLiveArchiveComplete

No parameters.

Run it live

GET /v1/usageA 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/usage

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": {
        "plan": "Complete",
        "key_prefix": "tta_live_7k2m",
        "calls_today": 214,
        "calls_this_month": 5120,
        "limits": {
            "per_minute": 120,
            "per_day": 50000
        },
        "resets_at": "2026-09-13T00:00:00Z",
        "data_window": {
            "from": null,
            "to": "today and scheduled"
        }
    },
    "meta": []
}

Example

curl

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

Python

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

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