Skip to main content
GET
List Competitions

Endpoint

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:

Parameters

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

Request

Response

Country Object

Competition Object

Images

Country Flag

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[]
Last modified on June 29, 2026