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 Match Lineup

Provides the lineups and formations for before the match has started.

Soccer Match Lineup Request URL

GET

References / Dependencies

 Tournament ID  The id of the tournament. You can find list of the tournament from Tournament List endpoint 
 Stage / Round Structure  Stage / Round structures change tournament by tournament. You can find the structures with Tournament Id from Tournament Info endpoint 
 Matches from Fixture  Match Ids can be retrieved from The fixture of the tournament. You can find all matches of the tournament from Tournament Fixture endpoint 
 Matches from Match List  Match Ids can be retrieved from The Daily Match List. You can find all matches in 7-days period from Match List endpoint 

Call Rate / Interval

Recommended API Call Interval at 1 hour before kickoff: 1 Request / Minute  Recommended API Call Interval at live: 6 Request / MinuteRecommended API Call Interval at 1 hour after game end: 12 Request / Hour 

IMPORTANT


  • This data can be retrieved for only ± 7 days.
  • Please, start your requesting 45 or 60 mins before the match is started. Because the lineup is served 45 or 60 mins before the match.
  • When the match is started, you can stop your requesting after 10 minutes and use larger intervals to not miss any updates if it is available. (E.g. request per 15 mins.)

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
matchIdINTR{matchId}The id of the match

Response Output

Response Output Definitions

match

DataTypeExampleDescription
idINT1307660The id of the match
dateDATE/STR30/01/2019 20:00:00The date of the match
tournament
DataTypeExampleDescription
nameSTREnglish Premier LeagueThe name of the tournament for the match
shortNameSTREPLThe short name of the tournament for the match
idINT2The id of the tournament for the match
stage
DataTypeExampleDescription
nameSTR2018/2019 SeasonThe name of the stage for the match
shortNameSTR18/19The short name of the stage for the match
idINT37295The id of the stage for the match
round
DataTypeExampleDescription
nameSTRRound 24The name of the round for the match
shortNameSTRW24The short name of the round for the match
idINT24The id of the round for the match
homeTeam/awayTeam
DataTypeExampleDescription
nameSTRLiverpoolThe name of the home/away team for the match
mediumNameSTRLiverpoolThe short name of the home/away team for the match
shortNameSTRLIVThe short name of the home/away for the match
idINT265The id of the home/away for the match
formation
DataTypeExampleDescription
idINT17The id of the formation
nameSTR4-2-3-1The name of the formation
manager
DataTypeExampleDescription
idINT43The id of the home/away manager
nameSTRJürgenThe first name of the home/away manager
surNameSTRKloppThe last name of the home/away manager
knownNameSTRJürgen KloppThe full name of the home/away manager
middleNameSTR
The middle name of the home/away manager
starting
player
DataTypeExampleDescription
idINT90877The id of the player
knownNameSTRSadio ManeThe known name of the player
knownNameMediumSTRS.ManeThe medium known name of the player
knownNameShortSTRManeThe short known name of the player
shirtNumberINT10The shirt(jersey) number of the player
country
DataTypeExampleDescription
idINT98The id of the player's country
nameSTRSenegalThe name of the player's country
shortNameSTRSENThe short name of the player's country
position
DataTypeExampleDescription
idINT3The id of the player's position
nameSTRMidfielderThe name of the player's position
shortNameSTRMFThe short name of the player's position
tactical
DataTypeExampleDescription
idINT20The id of the player's position
nameSTRAttacking Midfielder RightThe name of the player's position
shortNameSTRAMRThe short name of the player's position
bench
player
DataTypeExampleDescription
idINT35732The id of the player
knownNameSTRDejan LovrenThe known name of the player
knownNameMediumSTRD.LovrenThe medium known name of the player
knownNameShortSTRLovrenThe short known name of the player
shirtNumberINT6The shirt(jersey) number of the player
country
DataTypeExampleDescription
idINT40The id of the player's country
nameSTRCroatiaThe name of the player's country
shortNameSTRCROThe short name of the player's country
position
DataTypeExampleDescription
idINT2The id of the player's position
nameSTRDefenderThe name of the player's position
shortNameSTRDFThe short name of the player's position




2019 - Broadage Sports All rights reserved