curl --request GET \
--url https://api.sportquanta.com/v1/{league}/games \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sportquanta.com/v1/{league}/games"
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}/games', 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}/games",
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}/games"
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}/games")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sportquanta.com/v1/{league}/games")
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": {
"items": [
{
"id": "<string>",
"canonical_id": "<string>",
"external_ids": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"season": 123,
"season_label": "<string>",
"game_number": 123,
"game_type": "<string>",
"status": "<string>",
"status_text": "<string>",
"live_game_state": "<string>",
"final_reason": "<string>",
"schedule_date": "<string>",
"scheduled_start_utc": "<string>",
"home_team_id": "<string>",
"away_team_id": "<string>",
"venue_id": "<string>",
"neutral_site": true,
"game_code": "<string>",
"regulation_periods": 123,
"linescore": {
"home_score": 123,
"away_score": 123,
"period": 123,
"game_clock": "<string>",
"periods": [
{
"period": 123,
"home_score": 123,
"away_score": 123,
"period_type": "<string>"
}
]
},
"weather": {
"condition": "<string>",
"temperature_f": 123,
"wind_mph": 123,
"wind_direction": "<string>",
"observed_at": "<string>"
},
"attendance": 123,
"postseason_round": "<string>",
"is_division_game": true,
"is_conference_game": true
}
],
"next_cursor": "<string>"
},
"_meta": {
"request_id": "<string>",
"served_from": "live",
"cache_ttl_seconds": 123,
"provenance": {},
"availability": {}
}
}Games
Schedule list for the given league. Soccer leagues also expose this
as /v1/{league}/matches. Cursor-paginated; default limit 25, max 200.
Sport-specific filters: week applies to NFL only (regular-season
weeks 1–18; postseason weeks 1–4); game_type applies to NHL only
(preseason | regular | postseason | all-star | other).
Both are accepted on every league and ignored by the sports that
don’t use them.
Baseball leagues (mlb, kbo, npb) also support date ranges via
date_from / date_to and duplicate-safe upcoming lists via
upcoming=true, for example
/v1/npb/games?team_id=npb-SF&upcoming=true&limit=10.
If date is supplied it wins over date_from / date_to.
Requires the odds entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.
curl --request GET \
--url https://api.sportquanta.com/v1/{league}/games \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sportquanta.com/v1/{league}/games"
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}/games', 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}/games",
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}/games"
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}/games")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sportquanta.com/v1/{league}/games")
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": {
"items": [
{
"id": "<string>",
"canonical_id": "<string>",
"external_ids": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"season": 123,
"season_label": "<string>",
"game_number": 123,
"game_type": "<string>",
"status": "<string>",
"status_text": "<string>",
"live_game_state": "<string>",
"final_reason": "<string>",
"schedule_date": "<string>",
"scheduled_start_utc": "<string>",
"home_team_id": "<string>",
"away_team_id": "<string>",
"venue_id": "<string>",
"neutral_site": true,
"game_code": "<string>",
"regulation_periods": 123,
"linescore": {
"home_score": 123,
"away_score": 123,
"period": 123,
"game_clock": "<string>",
"periods": [
{
"period": 123,
"home_score": 123,
"away_score": 123,
"period_type": "<string>"
}
]
},
"weather": {
"condition": "<string>",
"temperature_f": 123,
"wind_mph": 123,
"wind_direction": "<string>",
"observed_at": "<string>"
},
"attendance": 123,
"postseason_round": "<string>",
"is_division_game": true,
"is_conference_game": true
}
],
"next_cursor": "<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: nhl.
nhl Query Parameters
Exact schedule date. Overrides date_from / date_to.
Baseball date range start, inclusive, in league-local schedule date.
Baseball date range end, inclusive, in league-local schedule date.
NFL-only week filter; ignored by other leagues.
NHL-only season-phase filter; ignored by other leagues.
preseason, regular, postseason, all-star, other Optional exact status filter. With upcoming=true, explicit postponed/cancelled filters are honored instead of the default playable-status set.
scheduled, live, final, postponed, cancelled Baseball-only duplicate-safe upcoming list. Defaults to league-local today through +30 days and excludes postponed/cancelled/final rows unless status is supplied.
1 <= x <= 200Opt 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.
Response
Page of games / matches.
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Opaque continuation cursor; omitted on the last page.
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.