Team Results

Get past match results for a specific team/competitor

GET /games/results

Completed Games

cURL

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

Team Results

Retrieve past match results for a specific team or competitor.

Important: Current Season Only

This endpoint returns results for the current season only by default. Pagination will stop at the beginning of the current season - you cannot paginate into previous seasons using aftergame and direction.

For multi-season historical data (e.g., 5 seasons for prediction modeling), see Historical Season Data.

Endpoint

GET /games/results

Description

Returns a list of completed games (results) for a specific competitor (team). This endpoint focuses on finished matches, providing final scores, statistics, and optional betting odds outcomes.

Parameters

Parameter	Type	Required	Description
competitors	number	No*	The competitor (team) ID to get results for
competitions	number	No*	Competition ID to filter by (e.g., 7 for Premier League)
aftergame	number	No	Game ID cursor for pagination (from paging.previousPage or paging.nextPage)
direction	number	No	Pagination direction: -1 for older games, 1 for newer games
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

*At least one of competitors or competitions should be provided to filter results.

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/results?competitors=110&showOdds=true" \
  -H "x-api-key: YOUR_API_KEY"

Response Structure

{
  "lastUpdateId": 5495176319,
  "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: 300s)
paging	object	Pagination links for previous/next pages
summary	object	Summary statistics (may be empty)
competitionFilters	array	Competitions the team has played 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 completed match 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’s Recent Results

Retrieve the latest match results for a specific team:

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

// All games returned are completed matches
results.games.forEach(game => {
  const homeScore = game.homeCompetitor.score;
  const awayScore = game.awayCompetitor.score;
  console.log(`${game.homeCompetitor.name} ${homeScore} - ${awayScore} ${game.awayCompetitor.name}`);
});

Calculate Form (Last 5 Games)

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

const teamId = 110;
const lastFive = results.games.slice(0, 5);

const form = lastFive.map(game => {
  const isHome = game.homeCompetitor.id === teamId;
  const teamScore = isHome ? game.homeCompetitor.score : game.awayCompetitor.score;
  const opponentScore = isHome ? game.awayCompetitor.score : game.homeCompetitor.score;
  
  if (teamScore > opponentScore) return 'W';
  if (teamScore < opponentScore) return 'L';
  return 'D';
});

console.log(`Form: ${form.join('')}`); // e.g., "WWDLW"

Filter Results by Competition

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

// Get only Premier League results
const premierLeagueId = 7;
const leagueResults = results.games.filter(
  game => game.competitionId === premierLeagueId
);

console.log(`Premier League games: ${leagueResults.length}`);

Comparison: Results vs Fixtures

Endpoint	Purpose	Games Returned
/games/results	Past matches	Only completed games
/games/fixtures	All matches	Both upcoming and completed

Use /games/results when you specifically need historical match data without upcoming fixtures.

Image URLs

Competition Logo

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

Pagination

This endpoint uses cursor-based pagination via the aftergame and direction parameters.

How It Works

1. Make your initial request without pagination parameters
2. The response includes a paging object with previousPage and nextPage URLs
3. Extract the aftergame value from these URLs for subsequent requests
4. Use direction=-1 for older games, direction=1 for newer games

Pagination Example

async function fetchAllTeamResults(teamId) {
  const allGames = [];
  let aftergame = null;
  
  while (true) {
    const params = new URLSearchParams({ competitors: teamId });
    if (aftergame) {
      params.set('aftergame', aftergame);
      params.set('direction', '-1'); // Get older games
    }
    
    const response = await fetch(
      `https://v1.football.sportsapipro.com/games/results?${params}`,
      { headers: { 'x-api-key': 'YOUR_API_KEY' } }
    );
    
    const data = await response.json();
    allGames.push(...data.games);
    
    // Check if there are more older games
    if (!data.paging?.previousPage) break;
    
    // Extract cursor for next page
    const match = data.paging.previousPage.match(/aftergame=(\d+)/);
    if (!match) break;
    aftergame = match[1];
    
    // Respect rate limits
    await new Promise(r => setTimeout(r, 100));
  }
  
  return allGames;
}

Notes

• The ttl value (300 seconds / 5 minutes) indicates how long the response can be cached
• Use paging.previousPage to navigate to older games, paging.nextPage for newer games
• Results are returned in reverse chronological order (most recent first)
• The competitionFilters array shows all competitions the team has played in
• Games include final scores, winner information, and optional betting outcome data
• When fetching historical data, use the cursor from paging.previousPage with direction=-1

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)

Response

200

Results retrieved successfully