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 Tournament Fixture

Provides the match list of the tournaments and works only for active season

Soccer Tournament Fixture Request URL

GET

References / Dependencies

 Tournament ID  The id of the tournament. You can find list of 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 

Call Rate / Interval

 Recommended API Call Interval: 3 Request / Hour   Daily Max API Call: 288 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: Copa America 

Response Output Definitions

match

DataTypeExampleDescription
idINT1307428The id of the match.
dateDATE/STR10/08/2018 19:00:00The kick-off date of the match, includes also time.
homeTeam / awayTeam
DataTypeExampleDescription
nameSTRManchester UnitedFull name of the home/away team.
shortNameSTRMANUShort name of the home/away team.
mediumNameSTRMan. UnitedMedium name of the home/away team.
isNationalSTRfalseDetermines the team is a club team or a national team.
idINT4The id of the home/away.
score
DataTypeExampleDescription
regularINT2The regular score of the match for home/away team
halfTimeINT1The half-time score of the match for home/away team
currentINT2The current score of the match (live and post) for home/away team
penaltiesINT2The penalty score of the match for home/away team
extraTimeINT2The extra time score of the match for home/away team
status
DataTypeExampleDescription
nameSTRFull TimeThe name of the status
shortNameSTRFTThe short name of the status
idINT5The id of the status
info
stadium
DataTypeExampleDescription
nameSTROld TraffordThe name of the stadium
idINT5The id of the stadium
referee
DataTypeExampleDescription
nameSTRAndre MarrinerThe name of the referee
idINT295The id of the stadium
stage
DataTypeExampleDescription
nameSTR2018/2019 SeasonThe name of the stage
shortNameSTR18/19The short name of the stage
idINT37295The id of the stage
round
DataTypeExampleDescription
nameSTRRound 1The name of the round
shortNameSTRW1The short name of the round
idINT1The id of the round
2019 - Broadage Sports All rights reserved