logologo
WIDGETSAPIPRICINGCOVERAGESUPPORT

Soccer API Tech Docs

Tech Docs Index

  • Documentation+
  • Widgets+
  • Lookups+
  • Global API+
  • Soccer API+
  • Basketball API+
  • Football API+
  • Baseball API+
  • Ice Hockey API+
  • Volleyball API+
  • Handball API+
  • Table Tennis API+
  • Tennis API+

Soccer API Tournament Info

Provides the information about tournaments. Names, Season, Stage(s)

For HTTP 401 errors, you can visit the Api Error Codes page to find out the reason.

Soccer Tournament Info Request URL

GET

References / Dependencies

 Tournament ID  The id of the tournament. You can find list of tournament from Tournament List endpoint 

Call Rate / Interval

 Recommended API Call Interval: 1 Request / Day   Daily Max API Call: 4 Request 

Request Headers

DataTypeO / RExampleDescription
languageIdINTR{languageId}The id of the language that you select.
Ocp-Apim-Subscription-KeySTR
R{yourOcp-Apim-Subscription-Key}Your account key.
AcceptSTROapplication/xmlSelection of data presentation type as XML/JSON.
 *O= Optional, R= Required

Request Parameters

DataTypeO / RExampleDescription
tournamentIdINTR{tournamentId}The id of the tournament.

Response Output

 sample - 1: English Premier League 
 sample - 2: UEFA Champions League 

Response Output Definitions

tournament

DataTypeExampleDescription
nameSTREnglish Premier LeagueThe name of the tournament.
shortNameSTREPLThe short name of the tournament.
mediumNameSTR
The medium name of the tournament.
globalNameSTREnglish Premier LeagueThe global name of the tournament.
localNameSTR
The local name of the tournament.
isOfficialBLNtrueDetermines that the tournament is official or unofficial.
isNationalBLNtrueDetermines that national team join or not into the tournament.
idINT2The id of the tournament.
season
DataTypeExampleDescription
nameSTR2021/2022The name of the season
shortNameSTR21/22The short name of the season
idINT10294The id of the season
country
DataTypeExampleDescription
nameSTREnglandThe name of the country
shortNameSTRENGThe short name of the country
idINT2The id of the country
participantType
DataTypeExampleDescription
nameSTRClubThe participant type of the tournament. Determines that the club or national teams can participate
idINT1The id of the participant type. 1 = Club, 2 = National
stages
DataTypeExampleDescription
nameSTRSeason 2021/2022The name of the stage
shortNameSTR21/22The short name of the stage
activeBLNtrueDetermines the stage is active or not
roundlessBLNfalseDetermines the stage is roundless or not
idINT44705The id of the stage
rounds
DataTypeExampleDescription
nameSTRRound 1The name of the round
shortNameSTRR1The short name of the round
activeBLNtrueDetermines the round is active or not
idINT1The id of the stage
tbr (Tie Break Rules)
DataTypeExampleDescription
awayGoalsBLNfalseDetermines the Away Goals tie break rule is used or not for that stage
extraTimeBLNfalseDetermines the Extra Time tie break rule is used or not for that stage
penaltiesBLNfalseDetermines the Penalties tie break rule is used or not for that stage
stageData
alternatives
DataTypeExampleDescription
tokenSTR146d5d1b-0dba-4de7-85b7-78cdc75d7f04The token of the alternatives stage data. Can be Supported, NotSupported or NotAvailable.
default
tournament
DataTypeExampleDescription
standingsSTRSupportedStage data parameter for standings products. Can be Supported, NotSupported or NotAvailable
leaderboards
DataTypeExampleDescription
goalSTRSupportedStage data parameter for goal leaderboard. Can be Supported, NotSupported or NotAvailable
assistSTRSupportedStage data parameter for assist leaderboard. Can be Supported, NotSupported or NotAvailable
yellowSTRSupportedStage data parameter for yellow card leaderboard. Can be Supported, NotSupported or NotAvailable
redSTRSupportedStage data parameter for red card leaderboard. Can be Supported, NotSupported or NotAvailable
bettingTables
DataTypeExampleDescription
underOverSTRSupportedStage data parameter for under over table. Can be Supported, NotSupported or NotAvailable
bothTeamsToScoreSTRSupportedStage data parameter for both teams to score table. Can be Supported, NotSupported or NotAvailable
totalGoalsSTRSupportedStage data parameter for total goals table. Can be Supported, NotSupported or NotAvailable
team
DataTypeExampleDescription
squadSTRSupportedStage data parameter for squad products. Can be Supported or NotSupported
match
DataTypeExampleDescription
scoresSTRLiveStage data parameter for match scores products. Can be Live, Post or NotSupported
lineupsSTRLiveStage data parameter for lineups. Can be Live, Post or NotSupported
formationsSTRLiveStage data parameter for formations. Can be Live, Post or NotSupported
statisticsSTRLiveStage data parameter for match statistics. Can be Live, Post or NotSupported
missings
DataTypeExampleDescription
injuredSTRSupportedStage data parameter for missing players(injured). Can be Supported or NotSupported
suspendedSTRSupportedStage data parameter for missing players(suspended). Can be Supported or NotSupported
summary
DataTypeExampleDescription
refereeSTRSupportedStage data parameter for products with referee. Can be Supported or NotSupported
stadiumSTRSupportedStage data parameter for products with stadium. Can be Supported or NotSupported
weatherSTRSupportedStage data parameter for products with weather. Can be Supported or NotSupported
events
DataTypeExampleDescription
onlyGoalsSTRLiveStage data parameter for products with the goal events. Can be Live, Post or NotSupported
onlyRedsSTRLiveStage data parameter for products with the red card events. Can be Live, Post or NotSupported
basicSTRLiveStage data parameter for products with the basic events. Can be Live, Post or NotSupported
advancedSTRLiveStage data parameter for products with the advanced events. Can be Live, Post or NotSupported
commentary
DataTypeExampleDescription
basicSTRLiveStage data parameter for the basic commentary. Can be Live, Post or NotSupported
advancedSTRLiveStage data parameter for the advanced commentary. Can be Live, Post or NotSupported
2019 - Broadage Sports All rights reserved