Overview

The NBA G League API delivers schedules, live scores, full boxscores and play-by-play, standings and rankings, playoff series, team and player profiles, and league-wide player movement (transfers and free agents) for the NBA G League, all through one consistent set of feeds.

This integration guide is a set of task-oriented pages: foundational pages that explain how the API is organized, and scenario pages that each walk one integration goal end to end with request and response samples.

The League in One Call

A single request returns the league and every season on file, including the current season structure. A selection from the response, showing the four phases of the 2025-26 season:

GET https://api.sportradar.com/nbdl/trial/v8/en/league/seasons.json
x-api-key: YOUR_API_KEY

{
  "league": {
    "id": "ac79301f-9b1a-4e72-a4cb-230d4418ae08",
    "name": "NBA G League",
    "alias": "NBDL"
  },
  "seasons": [
    {
      "id": "fbba7dc8-d6bf-4ce3-b63d-5a8626beaa49",
      "year": 2025,
      "status": "closed",
      "type": {
        "code": "EX",
        "name": "Exhibition"
      }
    },
    {
      "id": "e0eeac1f-0b20-4576-8f62-63ad4c712feb",
      "year": 2025,
      "status": "closed",
      "type": {
        "code": "PRE",
        "name": "Pre-season"
      }
    },
    {
      "id": "d32bbe62-5116-42c5-a96c-95ff0c87de03",
      "year": 2025,
      "start_date": "2026-03-31",
      "end_date": "2026-04-13",
      "status": "closed",
      "type": {
        "code": "PST",
        "name": "Post-season"
      }
    },
    {
      "id": "fea41a6e-80d4-4756-bfea-37c7b347a21a",
      "year": 2025,
      "start_date": "2025-12-19",
      "end_date": "2026-03-28",
      "status": "closed",
      "type": {
        "code": "REG",
        "name": "Regular Season"
      }
    },
    {
      "id": "ebf401bb-9bc2-4d18-832c-cd1d32f6dcdd",
      "year": 2025,
      "start_date": "2025-11-07",
      "end_date": "2025-12-22",
      "status": "closed",
      "type": {
        "code": "SC",
        "name": "Showcase Cup"
      }
    },
    {
      "id": "885e15b0-b071-49de-8d70-4b8f45a6b331",
      "year": 2025,
      "start_date": "2025-12-22",
      "end_date": "2025-12-23",
      "status": "closed",
      "type": {
        "code": "SCC",
        "name": "Showcase Cup Championship"
      }
    }
  ]
}

The G League year runs in phases, each addressed as its own season type: the Showcase Cup (SC) from November to late December, the Showcase Cup Championship (SCC), the Regular Season (REG) from late December to late March, and the Post-season (PST) in April. G League Fundamentals covers the full season model.

Guide Map

What the API Provides

• Schedules: full-season, daily, and playoff-series schedules with venues, broadcasts, and coverage flags
• Live game data: score, clock, and full team and player statistics from Game Summary, top performers from Game Boxscore, and an event-level stream from Game Play-by-Play with shot locations and possession
• Standings and rankings: conference and division tables with 30+ record splits, plus rankings with clinch markers
• Playoffs and tournaments: the postseason bracket as linked series, series-level statistics, and the Showcase Cup
• Rosters and players: team profiles with rosters and franchise honors, player profiles with per-season statistics, league leaders, free agents, and daily transfers
• Change detection: a daily change log listing every player, game, and team whose data changed that day

Both json and xml are available on every feed, carrying the same data.

Where to Start

1. Read G League API Basics for authentication, the URL shape, errors, and cache behavior.
2. Read G League Fundamentals for the season model, league structure, and the game feed set.
3. Read ID Handling for the ID model: Sportradar GUIDs, official league references, and cross-league player links.
4. Pick the scenario page that matches your integration goal from the Integration Scenarios index.