Every match of a competition (hosted WebStats): ids, status, venue, teams and scores.
Endpoint: GET https://hosted.dcd.shared.geniussports.com/{org}/en/competition/{comp_id}/schedule?roundNumber={round_number}
One row per match in page order. Scores are NA before tip-off and for some completed games whose score the page does not print. date_time is the page's text (local time, zone not stated). link_match_id is NA for orgs that hide match pages (FFBB); venue_id is NA when the venue is plain text. An unfilled play-off slot ('To be determined', no team or match link) takes the scope the page's other blocks prove; a page of nothing but such slots is refused.
Arguments
- org
Genius ORG code of the league (ESAKE, CEBL, BNXT, SLB, ...); see
genius_competitions().- comp_id
Genius competition id: one per org competition-season (
comp_idofgenius_competitions()), e.g. 49915.- round_number
Round to list; -1 (default) lists every round of the competition.
- return_parsed
Parse into a tibble (default
TRUE);FALSEreturns the parsed body or page record (a list):data.jsonas served plus_request(the ids asked for), or the sdv-internal-refs capture shape of a page.
Value
A wehoop_data tibble (a zero-row tibble with these columns when Genius answers
an empty valid page), or the raw list when return_parsed = FALSE:
| col_name | type | description |
| match_id | integer | From the block id extfix_<id>. Genius match id: the {matchId} of data.json and /u/; one global sequence across every Genius customer (~0.3 M in 2016, ~2.9 M in Oct 2026) |
| link_match_id | integer | Match id of the block's /match/<id>/summary link; equals match_id (the capture refuses a page where it does not); null when the org hides match pages (FFBB) |
| comp_id | integer | CompId of the match link, or of the team links when the org hides match pages (FFBB); equals the {compId} asked for. A 'To be determined' slot (no team or match link) takes the {compId} the page's other blocks prove |
| org | character | ORG code of the match link (or the team links, as comp_id) |
| status | character | Status from the block class STATUS_*: COMPLETE, SCHEDULED, POSTPONED, ... |
| date_time | character | Tip-off as displayed, 'Mon D, YYYY, h:mm AM' (local time, zone not stated); null when unscheduled |
| venue_id | integer | Genius venue id (the /venue/{id} of hosted pages); null when the venue is plain text (FFBB) |
| venue_name | character | Venue name as entered (local script) |
| home_team_id | integer | Home team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code |
| home_team_name | character | Home team full name |
| home_team_code | character | Home team code (local script possible) |
| home_score | integer | Home points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played) |
| away_team_id | integer | Away team: Genius team id (warehouse key space, global across orgs and seasons; the /team/{id} of hosted pages, the tid of the widget, the teamId of data/competition). data.json carries no team id: join on name/code |
| away_team_name | character | Away team full name |
| away_team_code | character | Away team code (local script possible) |
| away_score | integer | Away points; null before tip-off (typed integer only on a route whose 3 sampled rows were all played) |
Details
Access. The Genius hosts publish no robots.txt and no terms. CloudFront refuses
datacenter IPs on the LiveStats and hosted hosts: from a server set
options(wehoop.proxy = ...) or the GENIUS_PROXY environment variable to an http(s)
proxy URL (never printed or logged). Requests are spaced at least one second apart
per host; keep crawls slow and incremental. Some league sites (the NZ NBL) forbid AI
crawlers in their own robots.txt, which does not cover these hosts. Unofficial use of a
public source: payloads are not redistributed as release assets.
Org and season. Every competition is an ORG code plus a competition id
(comp_id): genius_competitions() lists an org's competitions with the sdv END-year
season (a START-year org lists 2025-26 as season 2026), genius_match_competition()
maps a game to its competition, and data.json itself names no date, competition or
season. The hosted ORG can differ from the LiveStats ORG of /u/ (NZNBL vs NZN). Match
ids are one global sequence across every Genius customer. data.json carries no global
team or player id: tno (1 or 2) and pno are in-game numbers; only finished games
are read.
Errors (classed conditions, all inheriting wehoop_error): wehoop_no_data when
Genius has nothing for the request (HTTP 404, the S3 AccessDenied 403, an empty 200
from the hosted host, an empty recent-games window, a schedule or widget with no
matches); wehoop_bad_request for HTTP 400 / 422 or a URL that is not a Genius route
(e.g. a non-numeric id); wehoop_asset_fetch when the answer is unknown: the CloudFront
"Request blocked" 403, a rate limit or 5xx, the intermittent HTTP 500 "A website error
has occurred" page (transient = TRUE: retry later), a dead connection, an error
envelope, a cut-off page, an unfinished game, or a body for another match, competition
or ORG.
See also
Other Genius Functions:
genius_competition_games(),
genius_competitions(),
genius_game(),
genius_game_crosswalk(),
genius_match_competition(),
genius_pbp(),
genius_player_box(),
genius_schedule_embed(),
genius_shots(),
genius_team_box(),
genius_team_crosswalk(),
genius_widget_games(),
lfb_competition,
wbbl_competition
Examples
# \donttest{
try(genius_schedule(org = "CEBL", comp_id = 47852))
#> ── Genius LiveStats schedule ─────────────────────────────────── wehoop 3.1.0 ──
#> ℹ Data updated: 2026-10-22 02:36:26 UTC
#> # A tibble: 130 × 16
#> match_id link_match_id comp_id org status date_time venue_id venue_name
#> <int> <int> <int> <chr> <chr> <chr> <int> <chr>
#> 1 2845983 2845983 47852 CEBL IN_PROGRE… May 7, 2… 21669 Envision …
#> 2 2798717 2798717 47852 CEBL COMPLETE May 9, 2… 34313 Edmonton …
#> 3 2845984 2845984 47852 CEBL COMPLETE May 9, 2… 21669 Envision …
#> 4 2848269 2848269 47852 CEBL SCHEDULED May 12, … 32575 CAA Centre
#> 5 2798718 2798718 47852 CEBL COMPLETE May 12, … 26743 The Arena…
#> 6 2798720 2798720 47852 CEBL COMPLETE May 14, … 21667 SaskTel C…
#> 7 2798722 2798722 47852 CEBL COMPLETE May 15, … 31169 Verdun Au…
#> 8 2798724 2798724 47852 CEBL COMPLETE May 15, … 32575 CAA Centre
#> 9 2798727 2798727 47852 CEBL COMPLETE May 16, … 32579 Canada Li…
#> 10 2798728 2798728 47852 CEBL COMPLETE May 16, … 34313 Edmonton …
#> # ℹ 120 more rows
#> # ℹ 8 more variables: home_team_id <int>, home_team_name <chr>,
#> # home_team_code <chr>, home_score <int>, away_team_id <int>,
#> # away_team_name <chr>, away_team_code <chr>, away_score <int>
# }