GET

games

fixtures

Upcoming Games

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

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

fetch('https://api.sportsapipro.com/v1/basketball/games/fixtures', 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/games/fixtures",
  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/games/fixtures"

	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/games/fixtures")

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

Team Fixtures

Retrieve fixtures (upcoming and past games) for a specific team or competitor.

Endpoint

GET /games/fixtures

Description

Returns a list of games for a specific competitor (team), including upcoming fixtures and past results. The response includes competition filters, game details, and optional betting odds.

Parameters

Parameter	Type	Required	Description
`competitors`	number	Yes	The competitor (team) ID to get fixtures for
`showOdds`	boolean	No	Include betting odds in response (default: `true`)
`includeTopBettingOpportunity`	number	No	Include top betting opportunities (1 = yes)
`topBookmaker`	number	No	Filter odds by specific bookmaker ID

Auto-Resolved Parameters

These parameters are automatically determined by the API based on the user’s context:

Parameter	Description
`appTypeId`	Client application type identifier
`langId`	Language identifier for localized content
`timezoneName`	User’s timezone for time formatting (can be overridden with IANA timezone, e.g., `America/New_York`)
`userCountryId`	User’s country for regional content

All startTime fields use ISO 8601 format with a dynamic timezone offset based on the resolved or specified timezone.

Request Example

curl -X GET "https://api.sportsapipro.com/v1/football/games/fixtures?competitors=110&showOdds=true" \
  -H "x-api-key: YOUR_API_KEY"

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

import requests

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

Response Structure

{
  "lastUpdateId": 5495172167,
  "requestedUpdateId": -1,
  "ttl": 300,
  "paging": {
    "previousPage": "/web/games/?competitors=110&direction=-1...",
    "nextPage": "/web/games/?competitors=110&direction=1..."
  },
  "summary": {},
  "competitionFilters": [...],
  "sports": [...],
  "countries": [...],
  "competitions": [...],
  "competitors": [...],
  "games": [...],
  "bookmakers": [...]
}

Response Fields

Root Object

Field	Type	Description
`lastUpdateId`	number	Internal versioning ID for caching and incremental updates
`requestedUpdateId`	number	The update ID requested by client (-1 = latest)
`ttl`	number	Time To Live in seconds (cache duration)
`paging`	object	Pagination links for previous/next pages
`summary`	object	Summary statistics (may be empty)
`competitionFilters`	array	Competitions the team participates in
`sports`	array	Sport definitions
`countries`	array	Country data for competitions
`competitions`	array	Full competition details
`competitors`	array	Team/competitor details
`games`	array	List of fixtures and results
`bookmakers`	array	Bookmaker information for odds

Competition Filter Object

{
  "id": 7,
  "countryId": 1,
  "sportId": 1,
  "name": "Premier League",
  "shortName": "EPL",
  "hasBrackets": false,
  "nameForURL": "premier-league",
  "popularityRank": 92856977,
  "imageVersion": 12,
  "currentStageType": 1,
  "color": "#075C9C",
  "competitorsType": 0,
  "currentPhaseNum": -1,
  "currentSeasonNum": 131,
  "currentStageNum": 1,
  "hideOnCatalog": false,
  "hideOnSearch": false,
  "isInternational": false
}

Field	Type	Description
`id`	number	Competition unique identifier
`countryId`	number	Country the competition belongs to
`sportId`	number	Sport type identifier
`name`	string	Full competition name
`shortName`	string	Abbreviated competition name
`longName`	string	Extended competition name (optional)
`hasBrackets`	boolean	Whether competition has bracket/knockout stages
`nameForURL`	string	URL-safe competition name
`popularityRank`	number	Popularity score for sorting
`imageVersion`	number	Version number for competition logo
`currentStageType`	number	Current stage type (1=league, 3=knockout)
`color`	string	Brand color for the competition (hex)
`competitorsType`	number	Type of competitors (0=clubs, 1=national teams)
`currentPhaseNum`	number	Current phase number (-1 if not applicable)
`currentSeasonNum`	number	Current season number
`currentStageNum`	number	Current stage number
`hideOnCatalog`	boolean	Whether to hide in catalog views
`hideOnSearch`	boolean	Whether to hide in search results
`isInternational`	boolean	Whether it’s an international competition

Paging Object

Field	Type	Description
`previousPage`	string	URL path to previous page of results
`nextPage`	string	URL path to next page of results

Use Cases

Get Team Schedule

Retrieve all upcoming and past fixtures for a specific team:

const teamId = 110; // Manchester City
const fixtures = await sportsApi.get('/games/fixtures', {
  competitors: teamId,
  showOdds: true
});

// Filter upcoming games (statusGroup 1 = Scheduled)
const upcomingGames = fixtures.games.filter(g => g.statusGroup === 1);

// Filter completed games (statusGroup 4 = Ended)
const completedGames = fixtures.games.filter(g => g.statusGroup === 4);

// Filter live games (statusGroup 2 = 1st half, 3 = 2nd half)
const liveGames = fixtures.games.filter(g => g.statusGroup === 2 || g.statusGroup === 3);

Filter by Competition

Use the competitionFilters to show fixtures by competition:

const fixtures = await sportsApi.get('/games/fixtures', {
  competitors: 110
});

// Group games by competition
const gamesByCompetition = {};
fixtures.games.forEach(game => {
  const compId = game.competitionId;
  if (!gamesByCompetition[compId]) {
    gamesByCompetition[compId] = [];
  }
  gamesByCompetition[compId].push(game);
});

// Get competition names
fixtures.competitionFilters.forEach(comp => {
  console.log(`${comp.name}: ${gamesByCompetition[comp.id]?.length || 0} games`);
});

Image URLs

Competition Logo

https://api.sportsapipro.com/v1/football/images/competitions/{id}?imageVersion={imageVersion}

Notes

The ttl value (300 seconds / 5 minutes) indicates how long the response can be cached
Use pagination links (paging.nextPage, paging.previousPage) to navigate through results
The competitionFilters array shows all competitions the team is participating in during the current season
Games are returned in chronological order, including both past results and upcoming fixtures

Authorizations

x-api-key

string

header

required

Your SportsAPI Pro API key

Query Parameters

competitions

integer

Filter by competition ID

Example:

132

date

string<date>

Filter by date (YYYY-MM-DD)

Example:

"2026-01-26"

Response

200

Fixtures retrieved successfully

Last modified on June 29, 2026

Upcoming Games

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

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

fetch('https://api.sportsapipro.com/v1/basketball/games/fixtures', 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/games/fixtures",
  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/games/fixtures"

	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/games/fixtures")

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

Team Fixtures

Team Fixtures

Endpoint

Description

Parameters

Auto-Resolved Parameters

Request Example

Response Structure

Response Fields

Root Object

Competition Filter Object

Paging Object

Use Cases

Get Team Schedule

Filter by Competition

Image URLs

Competition Logo

Notes

Authorizations

Query Parameters

Response

​Team Fixtures

​Endpoint

​Description

​Parameters

​Auto-Resolved Parameters

​Request Example

​Response Structure

​Response Fields

​Root Object

​Competition Filter Object

​Paging Object

​Use Cases

​Get Team Schedule

​Filter by Competition

​Image URLs

​Competition Logo

​Notes

Authorizations

Query Parameters

Response

Team Fixtures

Endpoint

Description

Parameters

Auto-Resolved Parameters

Request Example

Response Structure

Response Fields

Root Object

Competition Filter Object

Paging Object

Use Cases

Get Team Schedule

Filter by Competition

Image URLs

Competition Logo

Notes