# Basketball API > Read-only JSON API for NBA and EuroLeague data: standings, schedules, results, live scores with the quarter and clock, full box scores, player and team season statistics and leaderboards. Base URL: https://basketball-api.yuvron.online/v1. Every request needs a key: through RapidAPI (X-RapidAPI-Key) or one issued directly (X-Api-Key). Responses are { "data": ..., "meta": ... }; errors are { "error": { "code", "message" } }. Times are UTC ISO 8601. Competitions: nba, euroleague. Seasons look like 2025-26 and default to the current one. Season statistics take ?phase=regular (default) or ?phase=playoffs. ## Endpoints under /v1/{competition} - GET /: Competition overview - GET /standings: Standings - GET /teams: Teams in a season - GET /teams/{id}: One team - GET /teams/{id}/roster: Roster - GET /teams/{id}/games: A team's games - GET /teams/{id}/stats: Team season statistics - GET /teams/{id}/head-to-head/{otherId}: Head to head - GET /players: Players in a season - GET /players/{id}: Player - GET /players/{id}/games: Game log - GET /games: Schedule and results - GET /games/live: Live games - GET /games/today: Today's games - GET /games/next: Next games - GET /games/{id}: Box score - GET /leaders/{stat}: Season leaders ## Across competitions - GET /v1/competitions - GET /v1/games/live - GET /v1/players/{id} - GET /v1/search?q= ## Documents - OpenAPI 3.0: https://basketball-api.yuvron.online/openapi.json - Interactive documentation: https://basketball-api.yuvron.online/docs ## Articles - [Build a live NBA scoreboard](https://basketball-api.yuvron.online/blog/live-nba-scoreboard): A working scoreboard in about 70 lines: what /games/live returns, how to print the quarter and the clock, why you poll every 30 seconds, and why the key stays on your server. - [What's inside a box score](https://basketball-api.yuvron.online/blog/inside-a-box-score): A field-by-field walk through a real game response, the 2026 NBA Finals clincher: the score by quarter, starters and bench, minutes, shooting splits and plus-minus. - [Reading an NBA table: games behind, the play-in and ties](https://basketball-api.yuvron.online/blog/reading-basketball-standings): What winPct, gamesBehind and zone mean in a standings response, how half a game happens, and why Philadelphia finished above Orlando in 2025-26 on a worse point difference.