curl --request GET \
--url https://api.sportquanta.com/v1/{league}/teams/{id}/roster \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sportquanta.com/v1/{league}/teams/{id}/roster"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sportquanta.com/v1/{league}/teams/{id}/roster', 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.sportquanta.com/v1/{league}/teams/{id}/roster",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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.sportquanta.com/v1/{league}/teams/{id}/roster"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sportquanta.com/v1/{league}/teams/{id}/roster")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sportquanta.com/v1/{league}/teams/{id}/roster")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"active": true,
"id": "<string>",
"canonical_id": "<string>",
"external_ids": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"full_name": "<string>",
"given_name": "<string>",
"family_name": "<string>",
"known_as": "<string>",
"slug": "<string>",
"jersey_number": "<string>",
"position": "<string>",
"date_of_birth": "<string>",
"country": "<string>",
"nationality": "<string>",
"height_cm": 123,
"weight_kg": 123,
"headshot_asset_key": "<string>",
"official_headshot_url": "<string>",
"current_team_id": "<string>",
"localized_names": {},
"bats": "<string>",
"throws": "<string>",
"mlb_debut_date": "<string>"
}
],
"_meta": {
"request_id": "<string>",
"served_from": "live",
"cache_ttl_seconds": 123,
"provenance": {},
"availability": {}
}
}Team roster
Universal across baseball, basketball, soccer, football, and
hockey. Returns the sport-specific player records currently
attached to the team (currentTeamId), as filled by the
roster ingestion (24h cadence) and, for soccer, the
squad-membership reconciler. NFL rows carry the football
position cluster (QB/RB/WR/…), depth-chart slot, and draft
metadata; NHL rows carry the hockey position cluster
(C/LW/RW/D/G), shoots/catches handedness, and contract bits.
active defaults to true; set active=false to include
retired or released players still tagged with the team. Reads
are soft — a team whose roster has not been ingested yet
returns an empty array rather than 404.
Soccer responses also carry _meta.availability saying whether
an empty roster is expected: status is available (players
returned), not_available (the team’s squad page was fetched and
lists nobody, and no recent cup lineup names its players,
typically an amateur club that only appears in a domestic cup)
or unknown (empty with nothing saying that is expected: no
squad page fetched yet, a failed or partial fetch, or a squad
page or cup lineup that lists players),
with a reason and, when a squad page was checked,
checked_at.
Requires the stats entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.
curl --request GET \
--url https://api.sportquanta.com/v1/{league}/teams/{id}/roster \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sportquanta.com/v1/{league}/teams/{id}/roster"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sportquanta.com/v1/{league}/teams/{id}/roster', 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.sportquanta.com/v1/{league}/teams/{id}/roster",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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.sportquanta.com/v1/{league}/teams/{id}/roster"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sportquanta.com/v1/{league}/teams/{id}/roster")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sportquanta.com/v1/{league}/teams/{id}/roster")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"active": true,
"id": "<string>",
"canonical_id": "<string>",
"external_ids": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"full_name": "<string>",
"given_name": "<string>",
"family_name": "<string>",
"known_as": "<string>",
"slug": "<string>",
"jersey_number": "<string>",
"position": "<string>",
"date_of_birth": "<string>",
"country": "<string>",
"nationality": "<string>",
"height_cm": 123,
"weight_kg": 123,
"headshot_asset_key": "<string>",
"official_headshot_url": "<string>",
"current_team_id": "<string>",
"localized_names": {},
"bats": "<string>",
"throws": "<string>",
"mlb_debut_date": "<string>"
}
],
"_meta": {
"request_id": "<string>",
"served_from": "live",
"cache_ttl_seconds": 123,
"provenance": {},
"availability": {}
}
}Authorizations
Send a workspace API token in the Authorization: Bearer <token> header.
Path Parameters
League for this reference section: kbo.
kbo Query Parameters
Opt in to per-field provenance on supported single game, match, team, player, and venue reads. Lists and composites accept the flag but generally omit provenance. It is returned under _meta.provenance only when source metadata exists.
Basketball only: season start year or label such as 2025-26. Historical roster uses that season; omitted selects current roster.
Response
Array of sport-specific player records.
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
live, cache Response cache TTL; independent of source freshness. Omitted when zero.
Endpoint-specific availability context, including soccer roster coverage.