Team Rosters

Get team rosters and player information

GET /squads

Team Roster

cURL

curl --request GET \
  --url https://v1.basketball.sportsapipro.com/squads \
  --header 'x-api-key: <api-key>'

V1 Legacy Endpoint — This is a V1 API endpoint. For new integrations, we recommend using the Basketball V2 API which provides richer data and more endpoints.

Overview

Returns the current roster for a basketball team, including player details, positions, jersey numbers, and coaching staff.

Query Parameters

competitors · integer · required

Team/Competitor ID (e.g., 2827 for LA Lakers)

Code Examples

cURL

curl -X GET "https://v1.basketball.sportsapipro.com/squads?competitors=2827" \
  -H "x-api-key: YOUR_API_KEY"

Response Structure

squad · object

Team roster information

Show Squad Object

team · object

Team details (id, name, imageUrl)

players · array

Array of player objects

Show Player Object

id · integer

Player ID

name · string

Full name

jerseyNumber · integer

Jersey number

position · string

Position (PG, SG, SF, PF, C)

nationality · object

Country information

age · integer

Player age

height · string

Height (e.g., “6’9"")

imageUrl · string

Player photo URL

coaches · array

Array of coaching staff

Example Response

{
  "squad": {
    "team": {
      "id": 2827,
      "name": "Los Angeles Lakers",
      "imageUrl": "..."
    },
    "players": [
      {
        "id": 12345,
        "name": "LeBron James",
        "jerseyNumber": 23,
        "position": "SF",
        "age": 41,
        "height": "6'9\"",
        "nationality": {
          "id": 1,
          "name": "United States"
        },
        "imageUrl": "..."
      }
    ],
    "coaches": [
      {
        "id": 98765,
        "name": "JJ Redick",
        "role": "Head Coach"
      }
    ]
  }
}

Common Team IDs

Team	ID
Los Angeles Lakers	2827
Boston Celtics	2765
Golden State Warriors	2841
Miami Heat	2802
Real Madrid (EuroLeague)	275

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

competitors · integer · required

Team/Competitor ID

Example:

2827

Response

200

Team roster retrieved successfully