Documentation / Guides

Games and results

Fixtures and final scores in every competition: finding games by day, team or season, and what each game carries.

What it covers

Every game of every competition we hold, from the fixture to the final score: its competition and season, its stage and round, the venue's own calendar day, tip-off in UTC, both teams, the score, and the attendance and arena where the league gives them. Each game also carries has, which says whether its box score, play by play and shots are held, so your code can check before it asks.

How the records link

• A game names its competition (cp_), its season (ss_) and both teams (tm_) by id and name, so one answer is enough to file it.
• The game's own id (gm_) opens everything else about it: the score by period, the box score, the play by play and the shots.
• status is scheduled, final or no_result. A game moved to a later day stays scheduled; no_result means no score is coming. Seasons, stages and standings has the detail.

Common jobs

Yesterday's final scores

GET https://api.basketballapi.net/v1/results/yesterday

One day's games

GET https://api.basketballapi.net/v1/games?date=2026-10-19

A team's season

Find the ids on Teams and Seasons, then:

GET https://api.basketballapi.net/v1/games?team=tm_...&season=ss_...

One game with its score by period

GET https://api.basketballapi.net/v1/games/{id}

Lists come in pages (Paging). How far back each plan reaches is on Plans and limits.

Endpoints in this guide