Team Results

Retrieve past match results for a specific team or competitor.

Important: Current Season OnlyThis 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 -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

Make your initial request without pagination parameters
The response includes a paging object with previousPage and nextPage URLs
Extract the aftergame value from these URLs for subsequent requests
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

API Reference

⚽ Major Sports

🏈 Team Sports

🥊 Combat & Motorsport

🏓 Racquet & Cue Sports

🏟️ Indoor & Ice Sports

⚽ Football V1

🏀 Basketball V1

🎾 Tennis V1

🏒 Hockey V1

Team Results

Team Results

Endpoint

Description

Parameters

Auto-Resolved Parameters

Request Example

Response Structure

Response Fields

Root Object

Competition Filter Object

Paging Object

Use Cases

Get Team’s Recent Results

Calculate Form (Last 5 Games)

Filter Results by Competition

Comparison: Results vs Fixtures

Image URLs

Competition Logo

How It Works

Notes

Authorizations

Query Parameters

Response

API Reference

⚽ Major Sports

🏈 Team Sports

🥊 Combat & Motorsport

🏓 Racquet & Cue Sports

🏟️ Indoor & Ice Sports

⚽ Football V1

🏀 Basketball V1

🎾 Tennis V1

🏒 Hockey V1

​Team Results

​Endpoint

​Description

​Parameters

​Auto-Resolved Parameters

​Request Example

​Response Structure

​Response Fields

​Root Object

​Competition Filter Object

​Paging Object

​Use Cases

​Get Team’s Recent Results

​Calculate Form (Last 5 Games)

​Filter Results by Competition

​Comparison: Results vs Fixtures

​Image URLs

​Competition Logo

​Pagination

​How It Works

​Pagination Example

​Notes

Authorizations

Query Parameters

Response

Team Results

Endpoint

Description

Parameters

Auto-Resolved Parameters

Request Example

Response Structure

Response Fields

Root Object

Competition Filter Object

Paging Object

Use Cases

Get Team’s Recent Results

Calculate Form (Last 5 Games)

Filter Results by Competition

Comparison: Results vs Fixtures

Image URLs

Competition Logo

Pagination

How It Works

Pagination Example

Notes