# Basketball API

> One basketball API: 21 REST endpoints covering competitions, seasons, teams, games, box scores, play by play, shots and players.
> Factual data only: no predictions, ratings or tips.

## Complete reference

- [Full manual, one file](https://basketballapi.net/documentation/manual.md): every endpoint, parameter, example answer and guide in a single markdown document.
- [OpenAPI](https://api.basketballapi.net/v1/openapi.json): machine-readable API description.
- [Postman collection](https://basketballapi.net/documentation/postman): every endpoint, ready to send.

## Agent skill

- [Basketball API agent skill](https://basketballapi.net/.well-known/agent-skills/basketballapi/SKILL.md): how agents use Basketball API. Index: https://basketballapi.net/.well-known/agent-skills/index.json

## Guides

- [Quick start](https://basketballapi.net/documentation/quick-start): From no key to your first answer in a few minutes.
- [Authentication](https://basketballapi.net/documentation/authentication): Where your key goes, and how to keep it safe.
- [Limits and quotas](https://basketballapi.net/documentation/limits): Calls a day, calls a minute, how far back each plan reaches, and the headers that tell you what is left.
- [Paging](https://basketballapi.net/documentation/paging): Walking through long lists with page numbers or a cursor.
- [Errors](https://basketballapi.net/documentation/errors): Every error code, what it means and what to do about it.
- [Webhooks](https://basketballapi.net/documentation/webhooks): Final scores and finished periods posted to your server as they happen.
- [Seasons, stages and standings](https://basketballapi.net/documentation/stages): How a season is named, what each game stage and status means, how standings are worked out, and how box scores relate to the final score.
- [Changelog](https://basketballapi.net/documentation/changelog): What changed in the API, newest first.

## Endpoints

- [GET /v1/games](https://basketballapi.net/documentation/games): Games
- [GET /v1/games/{id}](https://basketballapi.net/documentation/game): One game
- [GET /v1/games/{id}/boxscore](https://basketballapi.net/documentation/boxscore): Box score
- [GET /v1/games/{id}/playbyplay](https://basketballapi.net/documentation/playbyplay): Play by play
- [GET /v1/games/{id}/shots](https://basketballapi.net/documentation/shots): Shots
- [GET /v1/results/yesterday](https://basketballapi.net/documentation/results-yesterday): Yesterday's results
- [GET /v1/players/{id}](https://basketballapi.net/documentation/player): One player
- [GET /v1/players/{id}/games](https://basketballapi.net/documentation/player-games): Player game log
- [GET /v1/players](https://basketballapi.net/documentation/players): Find players
- [GET /v1/players/{id}/seasons](https://basketballapi.net/documentation/player-seasons): Player seasons
- [GET /v1/teams/{id}/form](https://basketballapi.net/documentation/team-form): Team form
- [GET /v1/players/{id}/splits](https://basketballapi.net/documentation/player-splits): Player splits
- [GET /v1/standings](https://basketballapi.net/documentation/standings): Standings
- [GET /v1/teams/{id}/head-to-head](https://basketballapi.net/documentation/head-to-head): Head to head
- [GET /v1/stats/leaders](https://basketballapi.net/documentation/leaders): Leaders
- [GET /v1/competitions](https://basketballapi.net/documentation/competitions): Competitions
- [GET /v1/seasons](https://basketballapi.net/documentation/seasons): Seasons
- [GET /v1/teams](https://basketballapi.net/documentation/teams): Teams
- [GET /v1/teams/{id}](https://basketballapi.net/documentation/team): One team
- [GET /v1/teams/{id}/roster](https://basketballapi.net/documentation/team-roster): Team roster
- [GET /v1/usage](https://basketballapi.net/documentation/usage): Usage