/
v3.0.11Get access

getActiveCompetitions

Fetches active competitions by date, sport, and live status

Request parameters:

Name
DescriptionTypeValuesDefault
from
The starting boundary of the date range (Unix format)number--
to
The ending boundary of the date range (Unix format)number--
sportType
The category or classification of the sportstring"esport", "general", "virtual", "racing", "fighting"-
isLive
Filters competitions by their live statusbooleantrue / false-
sportId
Unique identifier for a single specific sportstring--
sportIds
A list or array of sport IDs to fetch active competitions for multiple sports simultaneouslyarray--

Call example:

getActiveCompetitions({
  sportId: 1,
  isLive: true,
  toDate: 1780012800,
  sportIds: [1, 2, 5],
  sportType: 'classic',
  fromDate: 1779840000
})

Response examples:

{
  code: 0,
  rid: '0',
  data: {
    result: 0,
    result_text: null,
    details: [{
      Id: 1,
      Name: 'Fotboll',
      Alias: 'Soccer',
      Regions: [{
        Id: 6,
        Name: 'Sydamerika',
        Alias: 'South America',
        Alpha2Code: '  ',
        Competitions: [{
          Id: 2985,
          Name: 'Sydamerikanska cupen'
        }, {
          Id: 2988,
          Name: 'Copa Libertadores'
        }]
      }]
    }]
  }
}

Response parameters:

NameDescriptionTypeValues
details
An array of objects representing the sports categoriesarray-
└─
object
└─ Id
Unique identifier for the sport categorynumber-
└─ Name
The primary or localized name of the sportstring-
└─ Alias
An alternative name or universal fallback name for the sportstring-
└─ Regions
A list of geographical zones or regions where competitions for this sport are organizedarray-
└─
object
└─ Id
Unique identifier for the specific regionnumber-
└─ Name
The primary or localized name of the regionstring-
└─ Alias
The alternative or universal name of the regionstring-
└─ Alpha2Code
Soonstring-
└─ Competitions
A list of specific tournaments, leagues, or cups taking place within this geographic regionarray-
└─
object
└─ Id
Unique identifier for the specific league, cup, or tournamentnumber-
└─ Name
The official or localized name of the competitionstring-