logologo
WIDGETSAPIPRICINGCOVERAGESUPPORT

Soccer API Tech Docs

Question & Answers

Tech Docs Index

  • Documentation
    • Main Page
  • Widgets
    • Widget Tech Docs
  • Lookups
    • Languages
    • Soccer Match Events Lookup
    • API Error Codes
    • Widget Error Codes
  • Global API
    • Sports List
    • Country List
    • Round List
    • Status List
  • Soccer API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Leaderboard: Goals
    • Leaderboard: Assists
    • Leaderboard: Yellow Cards
    • Leaderboard: Red Cards
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Missing Players List
    • Match Summary
    • Match Lineup
    • Match Statistics
    • Match Commentary
    • Match Events Basic
    • Match Events All
    • Team Squad
    • Team Squad with Statistics
    • Team Schedule
    • Recent Match List
    • Result Statistics
    • Referee Statistics
    • Team Streaks
    • Goal Analysis: Goal Minutes in Between
    • Goal Analysis: Scoring First in Between
    • Seasonal Goal Analysis: Scoring First
    • Seasonal Goal Analysis: Conceding First
    • Seasonal Goal Analysis: Goal Minutes
    • Seasonal Goal Analysis: Goal Conceded Minutes
    • Market Tables: Under/Over
    • Market Tables: Both Teams to Score
    • Market Tables: Total Goals
    • Seasonal Statistics: Goals
    • Seasonal Market Statistics: Goals
    • Market Statistics: Goals
  • Basketball API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Leaderboard: Points
    • Leaderboard: Assists
    • Leaderboard: Rebounds
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Match Summary
    • Match Boxscore
    • Match Statistics
    • Match Play by Play
    • Match Game Leaders
    • Team Squad
    • Team Schedule
    • Recent Match List
    • Result Statistics
    • Market Statistics (Points)
    • Quarter Analysis
    • Seasonal Advanced Team Statistics
    • Under / Over Analysis
    • Seasonal Statistics: Points
    • Seasonal Market Statistics: Points
    • Seasonal Statistics: Quarter Analysis
    • Match Margins
  • Football API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Match Boxscore
    • Match Game Leaders
    • Match Team Statistics
    • Match Key Statistics
    • Match Play by Play
  • Baseball API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
  • Ice Hockey API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Recent Match List
  • Volleyball API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Team Schedule
    • Recent Match List
    • Result Statistics: Points
    • Seasonal Statistics: Points
  • Handball API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Team Schedule
    • Recent Match List
    • Result Statistics: Goals
    • Seasonal Statistics: Goals

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 / Hour Recommended API Call Interval at 1 hour after game end: 12 Request / Hour 

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