logologo
WIDGETSAPIPRICINGCOVERAGESUPPORT

Football 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+

Football API Match List: All

Provides the daily match list in active season and includes scheduled, live and finished matches.

Football Match List: All Request URL

GET

References / Dependencies

   There is no references/dependencies for Match List. Match List endpoints works with only date parameter. 

Call Rate / Interval

 Recommended API Call Interval: 20 Request / Minute  Daily Max API Call: 28800 Request 

± 7 days Match Period


Match List data can be retrieved for only ± 7 days.

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
dateDATE/STRR{dd/MM/yyyy}Date of the match

Response Output

 sample 1 

Response Output Definitions

match

DataTypeExampleDescription
dateDATE/STR03/02/2019 23:30:00The starting date of the match, includes also time
idINT18656The id of the match
homeTeam/awayTeam
DataTypeExampleDescription
nameSTRLos Angeles RamsThe full name of the home/away team
shortNameSTRLARThe short name of the home/away team
mediumNameSTRRamsThe medium name of the home/away team
idINT31The id of the home/away team
score
DataTypeExampleDescription
regularINT
The regular score of the match for home/away team
halfTimeINT0The half-time score of the match for home/away team
currentINT3The current score of the match (live and post) for home/away team
quarter1INT0The 1st quarter score of the match for home/away team
quarter2INT0The 2nd quarter score of the match for home/away team
quarter3INT3The 3rd quarter score of the match for home/away team
quarter4INT3The 4th quarter score of the match for home/away team
overTimeINT0The overtime 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
tournament
DataTypeExampleDescription
nameSTRNational Football LeagueThe name of the tournament
shortNameSTRNFLThe short name of the tournament
idINT1The id of the tournament
stage
DataTypeExampleDescription
nameSTRSuper BowlThe name of the stage
shortNameSTRSBThe short name of the stage
idINT726The id of the stage
round
DataTypeExampleDescription
nameSTRSingle GameThe name of the round
shortNameSTRSGThe short name of the round
idINT209The id of the round
gameclock
DataTypeExampleDescription
minuteINT15Minute of the game
secondINT0Second of the game
2019 - Broadage Sports All rights reserved