Referee stats

KBL-only route. Per official named in the season's game extensions: games worked (main / sub role), overtime games, home wins, and both teams' fouls, free-throw attempts and points per game, with the season's league line and every game listed newest first. Officials are keyed by name (the KBL header publishes no official id). A season whose games carry no officials is 404 data_not_yet_available.

Requires the stats entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

GEThttps://api.sportquanta.com/v1/kbl/refereesTry it

GETGet a KBL season's officials with the games they worked

GEThttps://api.sportquanta.comhttps://api-stage.sportquanta.comhttp://localhost:8082/v1/kbl/referees

Send

Get a KBL season's officials with the games they worked

KBL-only route. Per official named in the season's game extensions: games worked (main / sub role), overtime games, home wins, and both teams' fouls, free-throw attempts and points per game, with the season's league line and every game listed newest first. Officials are keyed by name (the KBL header publishes no official id). A season whose games carry no officials is 404 data_not_yet_available.

Requires the stats entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

Authorization

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Bearer

Query

seasonintegerrequired

Get a KBL season's officials with the games they workedcURL

200Example

Reference context: KBL.

Overview · Response conventions

Get a KBL season's officials with the games they worked

curl --request GET \
  --url 'https://api.sportquanta.com/v1/kbl/referees?season=2000' \
  --header 'Authorization: Bearer <token>'

200 · Example

{
  "data": {
    "season": 0,
    "games": 0,
    "league": {
      "games": 0,
      "fouls_per_game": 0,
      "free_throw_attempts_per_game": 0,
      "points_per_game": 0,
      "home_wins": 0
    },
    "officials": [
      {
        "name": "<string>",
        "games": 0,
        "main_games": 0,
        "sub_games": 0,
        "overtime_games": 0,
        "home_wins": 0,
        "fouls_per_game": 0,
        "free_throw_attempts_per_game": 0,
        "points_per_game": 0,
        "games_list": [
          {
            "game_id": "<string>",
            "schedule_date": "<string>",
            "home_team_id": "<string>",
            "away_team_id": "<string>",
            "role": "<string>",
            "fouls": 0,
            "free_throw_attempts": 0,
            "points": 0,
            "overtime": true,
            "home_win": true
          }
        ]
      }
    ]
  },
  "_meta": {
    "request_id": "REQUEST_ID",
    "served_from": "live",
    "cache_ttl_seconds": 300
  }
}

Authorizations

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Query Parameters

seasonintegerrequired

Required range: 2000 <= x, x <= 2100

Response

200401403404422429500502503application/json

The season's officials.

dataobjectrequired

data.seasonintegerrequired

data.gamesintegerrequired

data.leagueobjectrequired

data.league.gamesintegerrequired

data.league.fouls_per_gamenumber | nullrequired

data.league.free_throw_attempts_per_gamenumber | nullrequired

data.league.points_per_gamenumber | nullrequired

data.league.home_winsintegerrequired

data.officialsobject[]required

data.officials.namestringrequired

data.officials.gamesintegerrequired

data.officials.main_gamesintegerrequired

data.officials.sub_gamesintegerrequired

data.officials.overtime_gamesintegerrequired

data.officials.home_winsintegerrequired

data.officials.fouls_per_gamenumber | nullrequired

data.officials.free_throw_attempts_per_gamenumber | nullrequired

data.officials.points_per_gamenumber | nullrequired

data.officials.games_listobject[]required

data.officials.games_list.game_idstringrequired

data.officials.games_list.schedule_datestringrequired

data.officials.games_list.home_team_idstringrequired

data.officials.games_list.away_team_idstringrequired

data.officials.games_list.rolestringrequired

data.officials.games_list.foulsintegerrequired

data.officials.games_list.free_throw_attemptsintegerrequired

data.officials.games_list.pointsintegerrequired

data.officials.games_list.overtimebooleanrequired

data.officials.games_list.home_winbooleanrequired

_metaobject

Response request/cache metadata. Optional evidence fields are specific to this handler; cache TTL does not measure source-data freshness.

_meta.request_idstring

_meta.served_fromenum<string>

Available options: live, cache

_meta.cache_ttl_secondsinteger

Response cache TTL; independent of source freshness. Omitted when zero.