List Competitions

Get all competitions and countries

GET /competitions

List Competitions

cURL

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

200

{
  "competitions": [
    {
      "id": 123,
      "name": "<string>",
      "country": {
        "id": 123,
        "name": "<string>"
      },
      "hasStandings": true,
      "hasBrackets": true
    }
  ]
}

Endpoint

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

Description

Returns a comprehensive list of all available competitions (leagues, cups, tournaments) along with all countries. This is the primary endpoint for discovering available football data.

When filtering by competitionIds, the response may include additional related competitions beyond those requested. Always filter the competitions array by the specific ID you need:

const targetCompetition = data.competitions.find(c => c.id === competitionId);

Parameters

Parameter	Type	Required	Default	Description
sports	number	No	1	Sport ID (1 = Football)
timezoneName	string	No	Auto	Timezone for date/time values (auto-resolved, or specify e.g., America/New_York)

Parameters like appTypeId, langId, timezoneName, and userCountryId are automatically resolved by the upstream service. You can override timezoneName to receive date/time values in a specific timezone.

Request

cURL

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

Response

{
  "lastUpdateId": 5493716652,
  "requestedUpdateId": -1,
  "ttl": 300,
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    }
  ],
  "countries": [
    {
      "id": 1,
      "name": "England",
      "totalGames": 23,
      "liveGames": 0,
      "nameForURL": "england",
      "imageVersion": 1
    },
    {
      "id": 2,
      "name": "Spain",
      "totalGames": 12,
      "liveGames": 0,
      "nameForURL": "spain",
      "imageVersion": 1
    }
  ],
  "competitions": [
    {
      "id": 7,
      "countryId": 1,
      "sportId": 1,
      "name": "Premier League",
      "longName": "English Premier League",
      "hasStandings": true,
      "hasBrackets": false,
      "hasStats": true,
      "hasTransfers": true,
      "totalGames": 10,
      "liveGames": 0,
      "nameForURL": "premier-league",
      "popularityRank": 500000000,
      "currentSeasonNum": 35,
      "currentStageNum": 1,
      "color": "#3D195B",
      "imageVersion": 5,
      "isActive": true
    }
  ]
}

Country Object

Field	Type	Description
id	number	Unique country identifier
name	string	Country name
totalGames	number	Total games today in this country
liveGames	number	Currently live games
nameForURL	string	URL-friendly name
imageVersion	number	Image version for cache busting
isInternational	boolean	Whether this is an international entity

Competition Object

Field	Type	Description
id	number	Unique competition identifier
countryId	number	Associated country ID
sportId	number	Sport ID (1 = Football)
name	string	Competition name
longName	string	Full competition name
hasStandings	boolean	Whether standings are available
hasBrackets	boolean	Whether brackets are available (cups)
hasStats	boolean	Whether statistics are available
totalGames	number	Total games today
liveGames	number	Currently live games
currentSeasonNum	number	Current season number
color	string	Brand color (hex)
imageVersion	number	Image version for logos
isActive	boolean	Whether competition is currently active

Images

Country Flag

https://v1.football.sportsapipro.com/images/countries/{countryId}?imageVersion={imageVersion}

Competition Logo

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

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

countryId · integer

Filter by country ID

Response

200 - application/json

Competitions retrieved successfully

competitions · object[]

Show child attributes