# API-Basketball

> Follow basketball with API-Basketball: games and live scores by quarter, standings, team season statistics, rosters, team and player box scores, head-to-head records and bookmakers' pre-match odds, for the NBA, its G League and more than 400 leagues and cups. Needs an API-SPORTS key; the free plan allows 100 requests a day.

App · Sports · 18 actions. Web page: https://docs.lodol.com/docs/integrations/api-basketball

## Actions

### Find leagues and cups

Find basketball competitions by name, country, season or type, each with its ID, logo, country and every season on file: its name, dates, and whether box scores, standings, rosters and odds are available. With no filter it lists all of them.

**Inputs**

- League (`league_id`, text): Optional. Only this competition. Pick one from the list, or pass a league ID such as 12 for the NBA.
- Search (`search`, text): Optional. Only names containing this, at least 3 characters.
- Country (`country`, text): Optional. Only this country, by name as the list gives it, such as USA or Spain.
- Season (`season`, text): Optional. Only this season, as the league names it: a span such as 2023-2024 for the NBA, or a year such as 2024. The free plan reads seasons starting in 2022 to 2024.
- Type (`league_type`, text): Optional. Only leagues, or only cups. One of: `league`, `cup`.

**Outputs**

- `count` (number): How many came back.
- `leagues` (list): The competitions.

**Example output**

```json
{
  "count": 1,
  "leagues": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 5,
        "name": "USA"
      },
      "id": 12,
      "logo": "https://media.api-sports.io/basketball/leagues/12.png",
      "name": "NBA",
      "seasons": [
        {
          "coverage": {
            "odds": false,
            "player_statistics": true,
            "players": true,
            "standings": true,
            "team_statistics": true
          },
          "end": "2026-06-14",
          "season": "2025-2026",
          "start": "2025-10-02"
        },
        {
          "coverage": {
            "odds": false,
            "player_statistics": false,
            "players": false,
            "standings": true,
            "team_statistics": false
          },
          "end": "2027-04-04",
          "season": "2026-2027",
          "start": "2026-10-03"
        }
      ],
      "type": "League"
    }
  ]
}
```

### Find players

Find players by name or ID, or list a team's roster for a season, each with their jersey number, position, country and age.

**Inputs**

- Player ID (`player_id`, text): Optional. Only this player, by ID, such as 526.
- Team ID (`team_id`, text): Optional. Only this team, by ID, such as 133 for the Boston Celtics.
- Season (`season`, text): Optional. Only this season, as the league names it: a span such as 2023-2024 for the NBA, or a year such as 2024. The free plan reads seasons starting in 2022 to 2024.
- Search (`search`, text): Optional. Only names containing this, at least 3 characters.

**Outputs**

- `count` (number): How many came back.
- `players` (list): The players.

**Example output**

```json
{
  "count": 1,
  "players": [
    {
      "age": 24,
      "country": "Canada",
      "id": 948,
      "name": "Banton Dalano",
      "number": 5,
      "position": "Guard"
    }
  ]
}
```

### Find teams

Find teams by name, by league and season, by country or by ID, each with its logo and country. A league's teams can include its All-Star sides, such as the NBA's East and West.

**Inputs**

- Team ID (`team_id`, text): Optional. Only this team, by ID, such as 133 for the Boston Celtics.
- Search (`search`, text): Optional. Only names containing this, at least 3 characters.
- League (`league_id`, text): Optional. Only this competition. Pick one from the list, or pass a league ID such as 12 for the NBA.
- Season (`season`, text): Optional. Only this season, as the league names it: a span such as 2023-2024 for the NBA, or a year such as 2024. The free plan reads seasons starting in 2022 to 2024.
- Country (`country`, text): Optional. Only this country, by name as the list gives it, such as USA or Spain.

**Outputs**

- `count` (number): How many came back.
- `teams` (list): The teams.

**Example output**

```json
{
  "count": 1,
  "teams": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 5,
        "name": "USA"
      },
      "id": 133,
      "logo": "https://media.api-sports.io/basketball/teams/133.png",
      "name": "Boston Celtics",
      "national": false
    }
  ]
}
```

### Get a game

Get one game by ID: its venue, status, the clock, and both sides' points by quarter and in overtime, live while it is being played.

**Inputs**

- Game ID (`game_id`, text, required): The game's ID, such as 372191. List games returns them.
- Time zone (`timezone`, text): Optional. Give dates and times in this time zone, such as America/New_York or Europe/Madrid. UTC when left empty.

**Outputs**

- `country` (object): A country, or a region such as World or Europe.
- `date` (text): When it starts, with the time zone's offset (ISO 8601).
- `id` (number): The game's ID.
- `league` (object): The competition, and the season this is from.
- `scores` (object): Both sides' scores.
- `stage` (text): The stage, when the API names one.
- `status` (object): Where the game stands.
- `teams` (object): Both sides.
- `time` (text): Its start time, HH:MM, in that time zone.
- `timestamp` (number): When it starts, as a Unix timestamp.
- `timezone` (text): The time zone date and time are given in.
- `venue` (text): Where it is played.
- `week` (text): The week or round, when the API names one.

**Example output**

```json
{
  "country": {
    "code": "US",
    "flag": "https://media.api-sports.io/flags/us.svg",
    "id": 5,
    "name": "USA"
  },
  "date": "2023-10-08T22:00:00+00:00",
  "id": 372191,
  "league": {
    "id": 12,
    "logo": "https://media.api-sports.io/basketball/leagues/12.png",
    "name": "NBA",
    "season": "2023-2024",
    "type": "League"
  },
  "scores": {
    "away": {
      "over_time": null,
      "quarters": [
        29,
        28,
        23,
        26
      ],
      "total": 106
    },
    "home": {
      "over_time": null,
      "quarters": [
        20,
        39,
        22,
        33
      ],
      "total": 114
    }
  },
  "stage": null,
  "status": {
    "long": "Game Finished",
    "short": "FT",
    "timer": null
  },
  "teams": {
    "away": {
      "id": 154,
      "logo": "https://media.api-sports.io/basketball/teams/154.png",
      "name": "Philadelphia 76ers"
    },
    "home": {
      "id": 133,
      "logo": "https://media.api-sports.io/basketball/teams/133.png",
      "name": "Boston Celtics"
    }
  },
  "time": "22:00",
  "timestamp": 1696802400,
  "timezone": "UTC",
  "venue": "TD Garden",
  "week": null
}
```

### Get account status

See the connected key's API-Basketball plan, when it renews, and how many of today's requests are used and left. It is free: it never counts against the day.

**Inputs**: None.

**Outputs**

- `active` (true/false): True while the subscription is active.
- `daily_limit` (number): Requests allowed a day.
- `plan` (text): The plan, such as Free.
- `requests_remaining` (number): Requests left today; the day starts at midnight UTC.
- `requests_today` (number): Requests used today.
- `subscription_end` (text): When the plan renews or ends.

**Example output**

```json
{
  "active": true,
  "daily_limit": 100,
  "plan": "Free",
  "requests_remaining": 88,
  "requests_today": 12,
  "subscription_end": "2027-10-01T00:00:00+00:00"
}
```

### Get player box scores

Get every player's box score for a game, or one player's for every game of a season: starter or bench, minutes, field goals, three-pointers and free throws, rebounds, assists and points.

**Inputs**

- Game ID (`game_id`, text): Optional. Every player's box score for this game. Set this, or a player and a season.
- Player ID (`player_id`, text): Optional. This player's box score for every game of the season below. Find players gives player IDs.
- Season (`season`, text): Optional. Only this season, as the league names it: a span such as 2023-2024 for the NBA, or a year such as 2024. The free plan reads seasons starting in 2022 to 2024.

**Outputs**

- `count` (number): How many came back.
- `players` (list): Each box score, a player in a game.

**Example output**

```json
{
  "count": 2,
  "players": [
    {
      "assists": 5,
      "field_goals": {
        "attempts": 0,
        "percentage": null,
        "total": 0
      },
      "freethrows_goals": {
        "attempts": 9,
        "percentage": null,
        "total": 7
      },
      "game_id": 372191,
      "minutes": "26:44",
      "player": {
        "id": 526,
        "name": "Tatum Jayson"
      },
      "points": 13,
      "rebounds": {
        "total": 10
      },
      "team": {
        "id": 133
      },
      "threepoint_goals": {
        "attempts": 4,
        "percentage": null,
        "total": 0
      },
      "type": "starters"
    },
    {
      "assists": 1,
      "field_goals": {
        "attempts": 0,
        "percentage": null,
        "total": 0
      },
      "freethrows_goals": {
        "attempts": 8,
        "percentage": null,
        "total": 5
      },
      "game_id": 372191,
      "minutes": "24:35",
      "player": {
        "id": 525,
        "name": "Porzingis Kristaps"
      },
      "points": 17,
      "rebounds": {
        "total": 5
      },
      "team": {
        "id": 133
      },
      "threepoint_goals": {
        "attempts": 3,
        "percentage": null,
        "total": 2
      },
      "type": "starters"
    }
  ]
}
```

### Get pre-match odds

Get bookmakers' pre-match odds for a game, or for a league's games in a season, optionally from one bookmaker or for one bet type. Odds appear 1 to 7 days before a game, are updated once a day and are kept for 7 days after it.

**Inputs**

- Game ID (`game_id`, text): Optional. Only this game's odds. Set this, or a league and a season.
- League (`league_id`, text): Optional. Only this competition. Pick one from the list, or pass a league ID such as 12 for the NBA.
- Season (`season`, text): Optional. Only this season, as the league names it: a span such as 2023-2024 for the NBA, or a year such as 2024. The free plan reads seasons starting in 2022 to 2024.
- Bookmaker (`bookmaker_id`, text): Optional. Only this bookmaker's odds. Pick one from the list.
- Bet type (`bet_id`, text): Optional. Only this kind of bet, such as Home/Away. Pick one from the list.

**Outputs**

- `count` (number): How many came back.
- `odds` (list): Each game's odds.

**Example output**

```json
{
  "count": 1,
  "odds": [
    {
      "bookmakers": [
        {
          "bets": [
            {
              "id": 2,
              "name": "Home/Away",
              "values": [
                {
                  "odd": 2.75,
                  "value": "Home"
                },
                {
                  "odd": 1.45,
                  "value": "Away"
                }
              ]
            }
          ],
          "id": 4,
          "name": "Bet365"
        }
      ],
      "country": {
        "code": "AU",
        "flag": "https://media.api-sports.io/flags/au.svg",
        "id": 1,
        "name": "Australia"
      },
      "game": {
        "country": {
          "code": "AU",
          "flag": "https://media.api-sports.io/flags/au.svg",
          "id": 1,
          "name": "Australia"
        },
        "date": "2026-10-02T09:30:00+00:00",
        "id": 501192,
        "league": {
          "id": 1,
          "logo": "https://media.api-sports.io/basketball/leagues/1.png",
          "name": "NBL",
          "season": "2026-2027",
          "type": "League"
        },
        "scores": {
          "away": {
            "over_time": null,
            "quarters": [
              null,
              null,
              null,
              null
            ],
            "total": null
          },
          "home": {
            "over_time": null,
            "quarters": [
              null,
              null,
              null,
              null
            ],
            "total": null
          }
        },
        "stage": null,
        "status": {
          "long": "Not Started",
          "short": "NS",
          "timer": null
        },
        "teams": {
          "away": {
            "id": 8,
            "logo": "https://media.api-sports.io/basketball/teams/8.png",
            "name": "Adelaide"
          },
          "home": {
            "id": 6,
            "logo": "https://media.api-sports.io/basketball/teams/6.png",
            "name": "Illawarra Hawks"
          }
        },
        "time": "09:30",
        "timestamp": 1790933400,
        "timezone": "UTC",
        "venue": "WIN Entertainment Centre",
        "week": "3"
      },
      "league": {
        "id": 1,
        "logo": "https://media.api-sports.io/basketball/leagues/1.png",
        "name": "NBL",
        "season": "2026-2027",
        "type": "League"
      }
    }
  ]
}
```

### Get standings

Get a season's tables, such as the NBA's two conferences and six divisions: each team's place, games played, won and lost with its win percentage, and points scored and allowed. Narrow to one team, stage or group.

**Inputs**

- League (`league_id`, text, required): The competition, such as 12 for the NBA. Pick one from the list, or pass a league ID from an earlier step.
- Season (`season`, text, required): The season as the league names it: a span such as 2023-2024 for the NBA, or a year such as 2024 for a league played within one. Find leagues lists each league's seasons. The free plan reads seasons starting in 2022 to 2024.
- Team ID (`team_id`, text): Optional. Only this team's line in each table it is in.
- Stage (`stage`, text): Optional. Only this stage, by name. List standings stages gives a season's stages.
- Group (`group`, text): Optional. Only this table, by name, such as Eastern Conference. List standings groups gives a season's groups.

**Outputs**

- `count` (number): How many came back.
- `standings` (list): The tables, in order.

**Example output**

```json
{
  "count": 1,
  "standings": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 5,
        "name": "USA"
      },
      "group": "Atlantic",
      "league": {
        "id": 12,
        "logo": "https://media.api-sports.io/basketball/leagues/12.png",
        "name": "NBA",
        "season": "2023-2024",
        "type": "League"
      },
      "stage": "NBA - Regular Season",
      "table": [
        {
          "description": "Promotion - NBA (Play Offs: 1/8-finals)",
          "form": null,
          "games": {
            "losses": {
              "percentage": 0.22,
              "total": 18
            },
            "played": 82,
            "wins": {
              "percentage": 0.78,
              "total": 64
            }
          },
          "points": {
            "against": 8957,
            "for": 9887
          },
          "position": 1,
          "team": {
            "id": 133,
            "logo": "https://media.api-sports.io/basketball/teams/133.png",
            "name": "Boston Celtics"
          }
        },
        {
          "description": "Promotion - NBA (Play Offs: 1/8-finals)",
          "form": null,
          "games": {
            "losses": {
              "percentage": 0.39,
              "total": 32
            },
            "played": 82,
            "wins": {
              "percentage": 0.61,
              "total": 50
            }
          },
          "points": {
            "against": 8873,
            "for": 9249
          },
          "position": 2,
          "team": {
            "id": 151,
            "logo": "https://media.api-sports.io/basketball/teams/151.png",
            "name": "New York Knicks"
          }
        }
      ]
    }
  ]
}
```

### Get team box scores

Get each side's box score for a game: field goals, three-pointers and free throws made and attempted, rebounds, assists, steals, blocks, turnovers and fouls. Updated every 30 to 120 seconds during a game.

**Inputs**

- Game ID (`game_id`, text, required): The game's ID, such as 372191. List games returns them.

**Outputs**

- `count` (number): How many came back.
- `game_id` (number): The game asked about.
- `teams` (list): Each side's box score.

**Example output**

```json
{
  "count": 2,
  "game_id": 372191,
  "teams": [
    {
      "assists": 19,
      "blocks": 6,
      "field_goals": {
        "attempts": 85,
        "percentage": 43,
        "total": 37
      },
      "freethrows_goals": {
        "attempts": 34,
        "percentage": 76,
        "total": 26
      },
      "game_id": 372191,
      "personal_fouls": 21,
      "rebounds": {
        "defense": 37,
        "offence": 12,
        "total": 49
      },
      "steals": 8,
      "team": {
        "id": 133
      },
      "threepoint_goals": {
        "attempts": 38,
        "percentage": 36,
        "total": 14
      },
      "turnovers": 16
    },
    {
      "assists": 19,
      "blocks": 6,
      "field_goals": {
        "attempts": 95,
        "percentage": 41,
        "total": 38
      },
      "freethrows_goals": {
        "attempts": 19,
        "percentage": 78,
        "total": 15
      },
      "game_id": 372191,
      "personal_fouls": 24,
      "rebounds": {
        "defense": 34,
        "offence": 14,
        "total": 48
      },
      "steals": 10,
      "team": {
        "id": 154
      },
      "threepoint_goals": {
        "attempts": 38,
        "percentage": 34,
        "total": 13
      },
      "turnovers": 14
    }
  ]
}
```

### Get team statistics

Get a team's season in one competition: games played, won, drawn and lost at home, away and in all, with win percentages, and points scored and allowed in total and per game.

**Inputs**

- League (`league_id`, text, required): The competition, such as 12 for the NBA. Pick one from the list, or pass a league ID from an earlier step.
- Season (`season`, text, required): The season as the league names it: a span such as 2023-2024 for the NBA, or a year such as 2024 for a league played within one. Find leagues lists each league's seasons. The free plan reads seasons starting in 2022 to 2024.
- Team ID (`team_id`, text, required): The team's ID, such as 133 for the Boston Celtics. Find teams looks one up. A team's ID is the same in every competition.
- Up to date (`on_date`, date): Optional. Count only games up to this day. The free plan takes only yesterday, today or tomorrow.

**Outputs**

- `country` (object): A country, or a region such as World or Europe.
- `games` (object): The team's record.
- `league` (object): The competition, and the season this is from.
- `points` (object): Points scored and allowed.
- `team` (object): A team.

**Example output**

```json
{
  "country": {
    "code": "US",
    "flag": "https://media.api-sports.io/flags/us.svg",
    "id": 5,
    "name": "USA"
  },
  "games": {
    "draws": {
      "all": {
        "percentage": 0.0,
        "total": 0
      },
      "away": {
        "percentage": 0.0,
        "total": 0
      },
      "home": {
        "percentage": 0.0,
        "total": 0
      }
    },
    "losses": {
      "all": {
        "percentage": 0.2,
        "total": 21
      },
      "away": {
        "percentage": 0.294,
        "total": 15
      },
      "home": {
        "percentage": 0.111,
        "total": 6
      }
    },
    "played": {
      "all": 105,
      "away": 51,
      "home": 54
    },
    "wins": {
      "all": {
        "percentage": 0.8,
        "total": 84
      },
      "away": {
        "percentage": 0.706,
        "total": 36
      },
      "home": {
        "percentage": 0.889,
        "total": 48
      }
    }
  },
  "league": {
    "id": 12,
    "logo": "https://media.api-sports.io/basketball/leagues/12.png",
    "name": "NBA",
    "season": "2023-2024",
    "type": "League"
  },
  "points": {
    "against": {
      "average": {
        "all": 107.4,
        "away": 108.3,
        "home": 106.6
      },
      "total": {
        "all": 11279,
        "away": 5525,
        "home": 5754
      }
    },
    "for": {
      "average": {
        "all": 118.3,
        "away": 115.7,
        "home": 120.8
      },
      "total": {
        "all": 12425,
        "away": 5902,
        "home": 6523
      }
    }
  },
  "team": {
    "id": 133,
    "logo": "https://media.api-sports.io/basketball/teams/133.png",
    "name": "Boston Celtics"
  }
}
```

### List bet types

List the kinds of bet API-Basketball has odds for, such as Home/Away or Over/Under, with the IDs the odds filter takes.

**Inputs**

- Search (`search`, text): Optional. Only names containing this, at least 3 characters.

**Outputs**

- `bets` (list): The bet types.
- `count` (number): How many came back.

**Example output**

```json
{
  "bets": [
    {
      "id": 1,
      "name": "3Way Result"
    },
    {
      "id": 2,
      "name": "Home/Away"
    }
  ],
  "count": 2
}
```

### List bookmakers

List the bookmakers API-Basketball has odds from, with the IDs the odds filter takes. These IDs are API-Basketball's own: the same bookmaker can have another ID in another API-SPORTS API.

**Inputs**

- Search (`search`, text): Optional. Only names containing this, at least 3 characters.

**Outputs**

- `bookmakers` (list): The bookmakers.
- `count` (number): How many came back.

**Example output**

```json
{
  "bookmakers": [
    {
      "id": 1,
      "name": "Bwin"
    },
    {
      "id": 2,
      "name": "Marathon Bet"
    }
  ],
  "count": 2
}
```

### List countries

List the countries and regions that have basketball competitions in API-Basketball, each with its ID, code and flag. The names are what the Country filters take.

**Inputs**

- Search (`search`, text): Optional. Only names containing this, at least 3 characters.
- Country code (`code`, text): Optional. Only the country with this two-letter code, such as US, ES or AU.

**Outputs**

- `count` (number): How many came back.
- `countries` (list): The countries.

**Example output**

```json
{
  "count": 1,
  "countries": [
    {
      "code": "US",
      "flag": "https://media.api-sports.io/flags/us.svg",
      "id": 5,
      "name": "USA"
    }
  ]
}
```

### List games

List games and results by day, by league and season, or by team, live ones included, each with its venue, status, the clock, and both sides' points by quarter and in overtime. Scores update every 15 seconds during a game.

**Inputs**

- Date (`on_date`, date): Optional. Only games on this day, in the time zone chosen below. The free plan takes only yesterday, today or tomorrow.
- League (`league_id`, text): Optional. Only this competition. Pick one from the list, or pass a league ID such as 12 for the NBA.
- Season (`season`, text): Optional. Only this season, as the league names it: a span such as 2023-2024 for the NBA, or a year such as 2024. The free plan reads seasons starting in 2022 to 2024.
- Team ID (`team_id`, text): Optional. Only this team, by ID, such as 133 for the Boston Celtics.
- Time zone (`timezone`, text): Optional. Give dates and times in this time zone, such as America/New_York or Europe/Madrid. UTC when left empty.

**Outputs**

- `count` (number): How many came back.
- `games` (list): The games, in the order given.

**Example output**

```json
{
  "count": 1,
  "games": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 5,
        "name": "USA"
      },
      "date": "2023-10-08T22:00:00+00:00",
      "id": 372191,
      "league": {
        "id": 12,
        "logo": "https://media.api-sports.io/basketball/leagues/12.png",
        "name": "NBA",
        "season": "2023-2024",
        "type": "League"
      },
      "scores": {
        "away": {
          "over_time": null,
          "quarters": [
            29,
            28,
            23,
            26
          ],
          "total": 106
        },
        "home": {
          "over_time": null,
          "quarters": [
            20,
            39,
            22,
            33
          ],
          "total": 114
        }
      },
      "stage": null,
      "status": {
        "long": "Game Finished",
        "short": "FT",
        "timer": null
      },
      "teams": {
        "away": {
          "id": 154,
          "logo": "https://media.api-sports.io/basketball/teams/154.png",
          "name": "Philadelphia 76ers"
        },
        "home": {
          "id": 133,
          "logo": "https://media.api-sports.io/basketball/teams/133.png",
          "name": "Boston Celtics"
        }
      },
      "time": "22:00",
      "timestamp": 1696802400,
      "timezone": "UTC",
      "venue": "TD Garden",
      "week": null
    }
  ]
}
```

### List head-to-head games

List the games two teams have played each other, in every season or only one league, season or day, with a count of each side's wins and points across the finished ones.

**Inputs**

- First team ID (`first_team_id`, text, required): One of the two teams, by ID, such as 133 for the Boston Celtics. The summary counts its wins first.
- Second team ID (`second_team_id`, text, required): The other team, by ID, such as 151 for the New York Knicks.
- League (`league_id`, text): Optional. Only this competition. Pick one from the list, or pass a league ID such as 12 for the NBA.
- Season (`season`, text): Optional. Only this season, as the league names it: a span such as 2023-2024 for the NBA, or a year such as 2024. The free plan reads seasons starting in 2022 to 2024.
- Date (`on_date`, date): Optional. Only games on this day, in the time zone chosen below. The free plan takes only yesterday, today or tomorrow.
- Time zone (`timezone`, text): Optional. Give dates and times in this time zone, such as America/New_York or Europe/Madrid. UTC when left empty.

**Outputs**

- `count` (number): How many came back.
- `games` (list): Their games.
- `summary` (object): A count of the finished games among them.

**Example output**

```json
{
  "count": 2,
  "games": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 5,
        "name": "USA"
      },
      "date": "2023-10-09T23:30:00+00:00",
      "id": 372195,
      "league": {
        "id": 12,
        "logo": "https://media.api-sports.io/basketball/leagues/12.png",
        "name": "NBA",
        "season": "2023-2024",
        "type": "League"
      },
      "scores": {
        "away": {
          "over_time": null,
          "quarters": [
            29,
            22,
            34,
            22
          ],
          "total": 107
        },
        "home": {
          "over_time": null,
          "quarters": [
            28,
            29,
            34,
            23
          ],
          "total": 114
        }
      },
      "stage": null,
      "status": {
        "long": "Game Finished",
        "short": "FT",
        "timer": null
      },
      "teams": {
        "away": {
          "id": 133,
          "logo": "https://media.api-sports.io/basketball/teams/133.png",
          "name": "Boston Celtics"
        },
        "home": {
          "id": 151,
          "logo": "https://media.api-sports.io/basketball/teams/151.png",
          "name": "New York Knicks"
        }
      },
      "time": "23:30",
      "timestamp": 1696894200,
      "timezone": "UTC",
      "venue": "Madison Square Garden",
      "week": null
    },
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 5,
        "name": "USA"
      },
      "date": "2023-10-17T23:30:00+00:00",
      "id": 372229,
      "league": {
        "id": 12,
        "logo": "https://media.api-sports.io/basketball/leagues/12.png",
        "name": "NBA",
        "season": "2023-2024",
        "type": "League"
      },
      "scores": {
        "away": {
          "over_time": null,
          "quarters": [
            30,
            30,
            28,
            22
          ],
          "total": 110
        },
        "home": {
          "over_time": null,
          "quarters": [
            41,
            37,
            22,
            23
          ],
          "total": 123
        }
      },
      "stage": null,
      "status": {
        "long": "Game Finished",
        "short": "FT",
        "timer": null
      },
      "teams": {
        "away": {
          "id": 151,
          "logo": "https://media.api-sports.io/basketball/teams/151.png",
          "name": "New York Knicks"
        },
        "home": {
          "id": 133,
          "logo": "https://media.api-sports.io/basketball/teams/133.png",
          "name": "Boston Celtics"
        }
      },
      "time": "23:30",
      "timestamp": 1697585400,
      "timezone": "UTC",
      "venue": "TD Garden",
      "week": null
    }
  ],
  "summary": {
    "draws": 0,
    "first_team_points": 230,
    "first_team_wins": 1,
    "played": 2,
    "second_team_points": 224,
    "second_team_wins": 1
  }
}
```

### List seasons

List the seasons API-Basketball has data for, as the Season fields take them: years such as 2024 for leagues played within one, and spans such as 2023-2024 for leagues like the NBA.

**Inputs**: None.

**Outputs**

- `count` (number): How many came back.
- `seasons` (list): The seasons, in order.

**Example output**

```json
{
  "count": 6,
  "seasons": [
    "2025-2026",
    "2026",
    "2026-2027",
    "2027",
    "2028",
    "2029"
  ]
}
```

### List standings groups

List the tables a competition's season has, such as the NBA's conferences and divisions, by the names Get standings takes as its Group.

**Inputs**

- League (`league_id`, text, required): The competition, such as 12 for the NBA. Pick one from the list, or pass a league ID from an earlier step.
- Season (`season`, text, required): The season as the league names it: a span such as 2023-2024 for the NBA, or a year such as 2024 for a league played within one. Find leagues lists each league's seasons. The free plan reads seasons starting in 2022 to 2024.

**Outputs**

- `count` (number): How many came back.
- `groups` (list): The groups, by name.

**Example output**

```json
{
  "count": 8,
  "groups": [
    "Western Conference",
    "Eastern Conference",
    "Atlantic",
    "Southeast",
    "Central",
    "Northwest",
    "Pacific",
    "Southwest"
  ]
}
```

### List standings stages

List the stages of a competition's season, such as the NBA's regular season, by the names Get standings takes as its Stage.

**Inputs**

- League (`league_id`, text, required): The competition, such as 12 for the NBA. Pick one from the list, or pass a league ID from an earlier step.
- Season (`season`, text, required): The season as the league names it: a span such as 2023-2024 for the NBA, or a year such as 2024 for a league played within one. Find leagues lists each league's seasons. The free plan reads seasons starting in 2022 to 2024.

**Outputs**

- `count` (number): How many came back.
- `stages` (list): The stages, by name.

**Example output**

```json
{
  "count": 1,
  "stages": [
    "NBA - Regular Season"
  ]
}
```
