Team Fixtures

Get upcoming and past fixtures for a specific team/competitor

GET /games/fixtures

Upcoming Games

cURL

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

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

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

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://v1.football.sportsapipro.com/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