Competition Standings

Endpoint

GET https://v1.football.sportsapipro.com/standings

Description

Returns the current standings/league table for a competition including team positions, statistics, recent form, next matches, and qualification zones. TTL: 300 seconds (5 minutes)

Common Use Case: The standings endpoint is the recommended way to get all team IDs (competitor IDs) for a competition. Use these IDs with /games/fixtures and /games/results to fetch team-specific match data.

Parameters

Parameter	Type	Required	Description
`competitions`	number	Yes*	Competition identifier (e.g., 7 for English Premier League)
`competitor`	number	Yes*	Competitor/team identifier (alternative to competitions)
`live`	boolean	No	Filter for live standings updates
`isPreview`	boolean	No	Include preview data
`stageNum`	number	No	Stage number to retrieve standings for
`seasonNum`	number	No	Season number to retrieve standings for
`type`	number	No	Filter type: 1=Overall, 2=Home, 3=Away
`withSeasonsFilter`	boolean	No	Include seasons filter data
`lastUpdateId`	number	No	For incremental updates (-1 for latest)
`timezoneName`	string	No	Timezone for date/time values (auto-resolved, or specify e.g., `America/New_York`)

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

*Either competitions or competitor is required.

Common Competition IDs

Competition	ID
English Premier League	7
La Liga	13
Bundesliga	8
Serie A	12
Ligue 1	35
UEFA Champions League	572
UEFA Europa League	573
UEFA Conference League	7685

Request Examples

Get EPL Standings (Premier League)

curl -X GET "https://v1.football.sportsapipro.com/standings?competitions=7" \
  -H "x-api-key: YOUR_API_KEY"

Get Standings with Season/Stage Filter

curl -X GET "https://v1.football.sportsapipro.com/standings?competitions=7685&stageNum=5&seasonNum=6" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "lastUpdateId": 5494811901,
  "requestedUpdateId": -1,
  "ttl": 300,
  "standings": [
    {
      "competitionId": 7685,
      "seasonNum": 6,
      "stageNum": 5,
      "isCurrentStage": true,
      "displayName": "UEFA Conference League",
      "currentGroupCategory": 0,
      "headers": [
        {
          "key": "gamePlayed",
          "name": "P",
          "isMajor": true
        },
        {
          "key": "goals",
          "name": "F:A",
          "isMajor": true
        },
        {
          "key": "ratio",
          "name": "+/-",
          "isMajor": true
        },
        {
          "key": "points",
          "name": "PTS",
          "isMajor": true
        },
        {
          "key": "gamesWon",
          "name": "W",
          "isMajor": false
        },
        {
          "key": "gamesEven",
          "name": "D",
          "isMajor": false
        },
        {
          "key": "gamesLost",
          "name": "L",
          "isMajor": false
        },
        {
          "key": "recentForm",
          "name": "Form",
          "isMajor": false
        },
        {
          "key": "nextMatch",
          "name": "Next",
          "isMajor": false
        }
      ],
      "rows": [
        {
          "competitor": {
            "id": 479,
            "countryId": 5,
            "sportId": 1,
            "name": "Strasbourg",
            "symbolicName": "STR",
            "nameForURL": "strasbourg",
            "type": 1,
            "popularityRank": 1572,
            "imageVersion": 1,
            "color": "#0034A5",
            "awayColor": "#FFFFFF",
            "mainCompetitionId": 35,
            "hasSquad": true,
            "hasTransfers": false
          },
          "gamePlayed": 5,
          "gamesWon": 4,
          "gamesLost": 0,
          "gamesEven": 1,
          "for": 8,
          "against": 4,
          "ratio": 4.0,
          "points": 13.0,
          "strike": 3,
          "gamesOT": 0,
          "gamesWonOnOT": 0,
          "gamesWonOnPen": 0,
          "gamesLossOnOT": 0,
          "gamesLossOnPen": 0,
          "pct": ".800",
          "position": 1,
          "trend": 0,
          "recentForm": [1, 1, 1, 2, 1],
          "detailedRecentForm": [
            {
              "id": 4538934,
              "sportId": 1,
              "competitionId": 7685,
              "startTime": "2025-12-11T20:00:00+00:00",
              "statusGroup": 4,
              "statusText": "Ended",
              "homeCompetitor": {
                "id": 761,
                "name": "Aberdeen",
                "score": 0.0,
                "isWinner": false
              },
              "awayCompetitor": {
                "id": 479,
                "name": "Strasbourg",
                "score": 1.0,
                "isWinner": true
              },
              "outcome": 1,
              "winner": 2,
              "scores": [0.0, 1.0]
            }
          ],
          "nextMatch": {
            "id": 4538911,
            "sportId": 1,
            "competitionId": 7685,
            "startTime": "2025-12-18T20:00:00+00:00",
            "statusGroup": 2,
            "statusText": "Scheduled",
            "homeCompetitor": {
              "id": 479,
              "name": "Strasbourg",
              "symbolicName": "STR"
            },
            "awayCompetitor": {
              "id": 2089,
              "name": "Breidablik"
            },
            "showCountdown": true
          },
          "destinationNum": 1,
          "destinationGuaranteed": true,
          "hasPointsDeduction": false,
          "ppg": 0.0,
          "oppg": 0.0
        }
      ],
      "destinations": [
        {
          "num": 1,
          "name": "Round of 16",
          "guaranteedText": "Round of 16",
          "color": "#2BE0D4",
          "type": 0
        },
        {
          "num": 2,
          "name": "Playoffs",
          "guaranteedText": "Playoffs",
          "color": "#AB2CF5",
          "type": 7
        }
      ],
      "filterTypes": [
        {
          "type": 1,
          "name": "Overall"
        },
        {
          "type": 2,
          "name": "Home"
        },
        {
          "type": 3,
          "name": "Away"
        }
      ]
    }
  ],
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    }
  ],
  "countries": [
    {
      "id": 19,
      "name": "Europe",
      "nameForURL": "europe",
      "sportTypes": [1, 2, 4, 5, 6, 7, 8, 9],
      "imageVersion": 1,
      "isInternational": true
    }
  ],
  "competitions": [
    {
      "id": 7685,
      "countryId": 19,
      "sportId": 1,
      "name": "UEFA Conference League",
      "shortName": "Conference League",
      "hasStandings": true,
      "hasBrackets": true,
      "nameForURL": "uefa-conference-league",
      "popularityRank": 7655344,
      "imageVersion": 6,
      "currentStageType": 1,
      "color": "#1D1D1D",
      "currentPhaseNum": 2,
      "currentPhaseName": "Main",
      "seasons": [
        {
          "num": 6,
          "name": "2025/2026",
          "hasStandings": true,
          "stages": [
            {
              "num": 5,
              "name": "League Phase",
              "hasStandings": true,
              "stageType": 1
            }
          ],
          "phases": [
            {
              "num": 2,
              "name": "Main",
              "isCurrentPhase": true
            }
          ]
        }
      ],
      "currentSeasonNum": 6,
      "currentStageNum": 5,
      "isInternational": true
    }
  ],
  "bookmakers": [
    {
      "id": 14,
      "name": "Bet365",
      "link": "https://extra.bet365.com/features/en/sports-live-streaming?affiliate=365_275195",
      "nameForURL": "bet365",
      "color": "#007B5B",
      "imageVersion": 3
    }
  ]
}

Standing Row Fields

Field	Type	Description
`competitor`	object	Team information with id, name, colors, etc.
`position`	number	Current league position
`gamePlayed`	number	Total matches played
`gamesWon`	number	Matches won
`gamesEven`	number	Matches drawn
`gamesLost`	number	Matches lost
`for`	number	Goals scored
`against`	number	Goals conceded
`ratio`	number	Goal difference
`points`	number	Total points
`strike`	number	Current winning/losing streak
`pct`	string	Win percentage
`trend`	number	Position trend (0=same, positive=up, negative=down)
`recentForm`	array	Last 5 results (1=win, 2=draw, 0=loss)
`detailedRecentForm`	array	Detailed recent match objects
`nextMatch`	object	Next scheduled match details
`destinationNum`	number	Qualification zone number
`destinationGuaranteed`	boolean	Whether qualification is guaranteed
`hasPointsDeduction`	boolean	Whether team has points deduction
`ppg`	number	Points per game
`oppg`	number	Opponent points per game

Headers Object

Field	Type	Description
`key`	string	Column identifier (gamePlayed, goals, ratio, points, etc.)
`name`	string	Display name (P, F:A, +/-, PTS, W, D, L, Form, Next)
`isMajor`	boolean	Whether column is a major/primary column

Destinations (Qualification Zones)

Field	Type	Description
`num`	number	Zone identifier
`name`	string	Zone name (e.g., “Round of 16”, “Playoffs”)
`guaranteedText`	string	Text shown when qualification is guaranteed
`color`	string	Zone color for visual display
`type`	number	Zone type identifier

Filter Types

The filterTypes array indicates available standings views:

Type	Name	Description
1	Overall	Combined home and away standings
2	Home	Home matches only
3	Away	Away matches only

Competition Seasons & Stages

The competitions array includes detailed season and stage information:

Field	Type	Description
`seasons`	array	Available seasons with stages and phases
`seasons[].num`	number	Season number
`seasons[].name`	string	Season display name (e.g., “2025/2026”)
`seasons[].stages`	array	Competition stages within season
`seasons[].phases`	array	Competition phases (Qualifications, Main, etc.)
`currentSeasonNum`	number	Current active season
`currentStageNum`	number	Current active stage

Recent Form Match Object

Field	Type	Description
`id`	number	Match identifier
`startTime`	string	Match start time (ISO 8601)
`statusGroup`	number	Status category (4=ended)
`statusText`	string	Status display text
`homeCompetitor`	object	Home team with score and winner status
`awayCompetitor`	object	Away team with score and winner status
`outcome`	number	Match outcome for the team
`winner`	number	Winner (1=home, 2=away, 0=draw)
`scores`	array	Final scores [home, away]

Notes

The type parameter filters standings by home/away performance
Use stageNum and seasonNum to get historical standings
The competitor parameter can be used instead of competitions to get standings for a specific team
Destinations indicate qualification zones with color coding for visual display
The detailedRecentForm includes full match details for recent games

Use Case: Get EPL Team IDs for Fixtures & Results

The standings endpoint is the recommended starting point for getting all team IDs in a competition. These IDs can then be used with /games/fixtures and /games/results to fetch team-specific match data.

Complete Workflow Example

const BASE_URL = "https://v1.football.sportsapipro.com";
const API_KEY = "YOUR_API_KEY";
const EPL_COMPETITION_ID = 7;

// Step 1: Get all EPL teams from standings
async function getEPLTeams() {
  const response = await fetch(
    `${BASE_URL}/standings?competitions=${EPL_COMPETITION_ID}`,
    { headers: { "x-api-key": API_KEY } }
  );
  const data = await response.json();
  
  return data.standings[0].rows.map(row => ({
    id: row.competitor.id,
    name: row.competitor.name,
    nameForURL: row.competitor.nameForURL,
    position: row.position,
    points: row.points,
    played: row.gamePlayed
  }));
}

// Step 2: Get fixtures for a specific team
async function getTeamFixtures(competitorId) {
  const response = await fetch(
    `${BASE_URL}/games/fixtures?competitors=${competitorId}&showOdds=true`,
    { headers: { "x-api-key": API_KEY } }
  );
  return response.json();
}

// Step 3: Get results for a specific team
async function getTeamResults(competitorId) {
  const response = await fetch(
    `${BASE_URL}/games/results?competitors=${competitorId}&showOdds=true`,
    { headers: { "x-api-key": API_KEY } }
  );
  return response.json();
}

// Example: Get all EPL teams and then fetch fixtures for the top team
async function main() {
  const teams = await getEPLTeams();
  console.log("EPL Teams:", teams);
  
  // Get fixtures for the team in 1st place
  const topTeam = teams.find(t => t.position === 1);
  console.log(`\nFetching fixtures for ${topTeam.name}...`);
  
  const fixtures = await getTeamFixtures(topTeam.id);
  console.log(`Found ${fixtures.games?.length || 0} upcoming fixtures`);
  
  // Get results for the same team
  const results = await getTeamResults(topTeam.id);
  console.log(`Found ${results.games?.length || 0} past results`);
}

main();

Sample EPL Team IDs (2025/2026 Season)

Team IDs are stable identifiers. The example below shows common EPL teams - use the standings endpoint for the authoritative current list.

Team	ID	nameForURL
Arsenal	48	arsenal
Chelsea	104	chelsea
Liverpool	25	liverpool
Manchester City	27	manchester-city
Manchester United	26	manchester-united
Tottenham	14	tottenham

Building Match URLs

Use the nameForURL field from competitor objects to construct SEO-friendly URLs:

// Build a match page URL
function buildMatchURL(game) {
  const home = game.homeCompetitor.nameForURL;
  const away = game.awayCompetitor.nameForURL;
  const gameId = game.id;
  return `/football/match/${home}-vs-${away}/${gameId}`;
}

// Example output: /football/match/arsenal-vs-chelsea/4538934

/games/fixtures - Get upcoming matches for a team
/games/results - Get past match results for a team
/games/best-practices - Endpoint selection guide and backfill patterns

Authorizations

x-api-key

string

header

required

Your SportsAPI Pro API key

Query Parameters

competitions

integer

required

Competition ID (e.g., 132 for NBA)

Example:

132

season

string

Season identifier (defaults to current)

Response

200 - application/json

Standings retrieved successfully

standings

object[]

Show child attributes

API Reference

⚽ Major Sports

🏈 Team Sports

🥊 Combat & Motorsport

🏓 Racquet & Cue Sports

🏟️ Indoor & Ice Sports

⚽ Football V1

🏀 Basketball V1

🎾 Tennis V1

🏒 Hockey V1

Endpoint

Description

Parameters

Common Competition IDs

Request Examples

Get EPL Standings (Premier League)

Get Standings with Season/Stage Filter

Response

Standing Row Fields

Headers Object

Destinations (Qualification Zones)

Filter Types

Competition Seasons & Stages

Recent Form Match Object

Notes

Use Case: Get EPL Team IDs for Fixtures & Results

Complete Workflow Example

Sample EPL Team IDs (2025/2026 Season)

Building Match URLs

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

​Endpoint

​Description

​Parameters

​Common Competition IDs

​Request Examples

​Get EPL Standings (Premier League)

​Get Standings with Season/Stage Filter

​Response

​Standing Row Fields

​Headers Object

​Destinations (Qualification Zones)

​Filter Types

​Competition Seasons & Stages

​Recent Form Match Object

​Notes

​Use Case: Get EPL Team IDs for Fixtures & Results

​Complete Workflow Example

​Sample EPL Team IDs (2025/2026 Season)

​Building Match URLs

​Related Endpoints

Authorizations

Query Parameters

Response

Endpoint

Description

Parameters

Common Competition IDs

Request Examples

Get EPL Standings (Premier League)

Get Standings with Season/Stage Filter

Response

Standing Row Fields

Headers Object

Destinations (Qualification Zones)

Filter Types

Competition Seasons & Stages

Recent Form Match Object

Notes

Use Case: Get EPL Team IDs for Fixtures & Results

Complete Workflow Example

Sample EPL Team IDs (2025/2026 Season)

Building Match URLs

Related Endpoints