Team Squad

GET

squads

Team Roster

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/basketball/squads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/basketball/squads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/basketball/squads"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/basketball/squads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

Overview

Returns the full squad information for a specified team (competitor), including all players, coaching staff, and position categories. This endpoint provides comprehensive athlete data such as age, jersey number, nationality, and formation positions.

User language, timezone, and country are automatically resolved. You can override timezoneName with a specific timezone (e.g., America/New_York). All date/time fields like birthdate use ISO 8601 format with a dynamic timezone offset.

Request Parameters

integer

required

The unique identifier of the team/competitor to retrieve squad for.Example: 110 (Manchester City)

integer

Identifies the client application type.Default: Automatically resolved

integer

Language identifier for localized content.Default: Automatically resolved

string

Timezone for date/time values (auto-resolved, or specify e.g., America/New_York). All date/time fields like birthdate use ISO 8601 format with a dynamic timezone offset.Default: Automatically resolved

integer

Country identifier for regional content.Default: Automatically resolved

Request Examples

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

const response = await fetch(
  'https://api.sportsapipro.com/v1/football/squads?competitors=110',
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  }
);
const data = await response.json();

import requests

response = requests.get(
    'https://api.sportsapipro.com/v1/football/squads',
    params={'competitors': 110},
    headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()

Response Example

{
  "squads": [
    {
      "competitorId": 110,
      "athletes": [
        {
          "age": 25,
          "jerseyNum": 9,
          "birthdate": "2000-07-21T00:00:00+00:00",
          "gender": 1,
          "position": {
            "id": 4,
            "name": "Attacker"
          },
          "formationPosition": {
            "id": 12,
            "name": "Centre Forward",
            "order": 12
          },
          "height": 195,
          "id": 65760,
          "name": "Erling Haaland",
          "shortName": "Haaland",
          "nameForURL": "erling-haaland",
          "sportId": 1,
          "clubId": 110,
          "nationalityId": 27,
          "nationalTeamId": 2376,
          "imageVersion": 67
        },
        {
          "age": 54,
          "birthdate": "1971-01-18T00:00:00+00:00",
          "gender": 1,
          "position": {
            "id": 0
          },
          "formationPosition": {
            "id": 16,
            "name": "Coach",
            "order": 16
          },
          "height": 180,
          "id": 46115,
          "name": "Pep Guardiola",
          "shortName": "Guardiola",
          "nameForURL": "guardiola",
          "sportId": 1,
          "clubId": 110,
          "nationalityId": 2,
          "nationalTeamId": 5050,
          "imageVersion": 28
        }
      ],
      "positions": [
        {
          "id": 0,
          "name": "Management",
          "title": "Management",
          "isStaff": true
        },
        {
          "id": 1,
          "name": "Goalkeeper",
          "title": "Goalkeepers",
          "isStaff": false
        },
        {
          "id": 2,
          "name": "Defender",
          "title": "Defenders",
          "isStaff": false
        },
        {
          "id": 3,
          "name": "Midfielder",
          "title": "Midfielders",
          "isStaff": false
        },
        {
          "id": 4,
          "name": "Attacker",
          "title": "Attackers",
          "isStaff": false
        }
      ]
    }
  ],
  "sports": [...],
  "countries": [...],
  "competitions": [...],
  "competitors": [...]
}

Response Fields

Root Object

array

Array of squad objects for the requested team(s).

array

Array of sport definitions referenced in the response.

array

Array of country definitions for player nationalities.

array

Array of competition definitions the team participates in.

array

Array of competitor/team definitions.

Squad Object

integer

The unique identifier of the team this squad belongs to.

array

Array of athlete objects representing all squad members.

array

Array of position category definitions used to group athletes.

Athlete Object

integer

Unique identifier for the athlete.

string

Full name of the athlete.

string

Abbreviated name for display purposes.

string

URL-friendly slug of the athlete’s name.

integer

Current age of the athlete in years.

integer

Jersey/shirt number worn by the athlete. Not present for coaching staff.

string

ISO 8601 formatted birth date with timezone.

integer

Gender identifier (1 = Male, 2 = Female).

integer

Height of the athlete in centimeters.

object

Primary position category of the athlete.

Show Position properties

integer

Position category ID (0=Management, 1=Goalkeeper, 2=Defender, 3=Midfielder, 4=Attacker).

string

Display name of the position category.

object

Specific formation position of the athlete.

Show Formation position properties

integer

Formation position ID.

string

Display name (e.g., “Centre Forward”, “Left Back”, “Coach”).

integer

Display order for sorting positions.

integer

Sport identifier (1 = Football).

integer

Current club/team identifier.

integer

Country ID representing the athlete’s nationality.

integer

National team ID if the athlete represents a national team.

integer

Version number for athlete image caching.

string

ISO 8601 timestamp when the athlete record was created.

Position Category Object

integer

Unique identifier for the position category.

string

Short name of the position (e.g., “Goalkeeper”, “Defender”).

string

Plural display title for grouping (e.g., “Goalkeepers”, “Defenders”).

boolean

Whether this category represents non-playing staff (coaches, managers).

Position Categories

ID	Name	Title	Is Staff
0	Management	Management	Yes
1	Goalkeeper	Goalkeepers	No
2	Defender	Defenders	No
3	Midfielder	Midfielders	No
4	Attacker	Attackers	No

Formation Positions

ID	Name	Order
1	Goalkeeper	1
3	Left Back	3
4	Defensive Midfield	4
5	Centre Back	5
6	Right Back	6
8	Central Midfield	8
9	Attacking Midfield	9
11	Left Forward	11
12	Centre Forward	12
14	Right Forward	14
16	Coach	16

Notes

The squad includes both players and coaching staff
Coaching staff members (position ID 0) do not have jersey numbers
Athletes may have both position (category) and formationPosition (specific role)
The positions array provides category definitions for grouping athletes in the UI
Use imageVersion when constructing athlete image URLs for cache busting

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

Last modified on June 29, 2026

Team Roster

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/basketball/squads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/basketball/squads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/basketball/squads"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/basketball/squads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Overview

Request Parameters

Request Examples

Response Example

Response Fields

Root Object

Squad Object

Athlete Object

Position Category Object

Position Categories

Formation Positions

Notes

Authorizations

Query Parameters

Response

​Overview

​Request Parameters

​Request Examples

​Response Example

​Response Fields

​Root Object

​Squad Object

​Athlete Object

​Position Category Object

​Position Categories

​Formation Positions

​Notes

Authorizations

Query Parameters

Response

Overview

Request Parameters

Request Examples

Response Example

Response Fields

Root Object

Squad Object

Athlete Object

Position Category Object

Position Categories

Formation Positions

Notes