logologo
WIDGETSAPIPRICINGCOVERAGESUPPORT

Football 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

Football API Match List: Results

Provides only the daily results in active season.

Football Match List: Results 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
nameSTRNew England PatriotsThe full name of the home/away team
shortNameSTRNEThe short name of the home/away team
mediumNameSTRPatriotsThe medium name of the home/away team
idINT5The id of the home/away team
score
DataTypeExampleDescription
currentINT13The current score of the match (live and post) for home/away team
quarter1INT0The 1st quarter score of the match for home team
quarter2INT3The 2nd quarter score of the match for home team
halfTimeINT3The half-time score of the match for home team
quarter3INT3The 3rd quarter score of the match for home team
quarter4INT13The 4th quarter score of the match for home team
regularINT13The regular score of the match for home team
overTimeINT0The regular score of the match for home team
status
DataTypeExampleDescription
nameSTRFull TimeThe name of the status
shortNameSTRFTThe short name of the status
idINT5The id of the status
gameClock
DataTypeExampleDescription
minuteINT5Minute of the match
secondINT18Second of the match
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
2019 - Broadage Sports All rights reserved