Schedule & Results

Update Time: 2020-06-03 11:21


This API endpoint returns detailed information of matches. You can use it with the Match Modify Record endpoint.

Related Plans

You can use this api by subscribing plans:  Live Data.


  • Path: /sport/football/schedule
  • Method: GET
  • Calls: Unlimited calls for paid plans, 200 calls per day for free trial.
  • Recommend Calls: 12 hour/call
  • Parameters: The request path needs at least one parameter (date, leagueId, and matchId ) to retrieve correct response. These three parameters can not be used at the same time.
datestringfalseyyyy-mm-dd, e.g. 2019-08-01.
The historical schedule data is limited to query the past month.
seasonstringfalseUse with leagueId to get the specified season, e.g.2018-2019.
Return to the current season by default
subLeagueIdstringfalseUse with leagueId to get the specified sub league.
stageIdstringfalseUse with leagueId to get the specified cup stage.
matchIdstringfalseSupport querying the current season's matches.


matchId string
leagueType int1: League
2: Cup
leagueId string
leagueName stringFull name, e.g. Brazil Serie A
leagueShortName stringShort name, e.g. BRA D1
subLeagueId string
subLeagueName stringThe on-going sub league of the league, e.g. Western Paly Off
matchTime intMatch scheduled time, unix timestamp
halfStartTime intThe kick-off time of the first half or the second half, unix timestamp
status int0: Not started
1: First half
2: Half-time break
3: Second half
4: Extra time
5: Penalty
-1: Finished
-10: Cancelled
-11: TBD
-12: Terminated
-13: Interrupted
-14: Postponed
homeId string
homeName string
awayId string
awayName string
homeScore int
awayScore int
homeHalfScore intFirst half score, home team
awayHalfScore intFirst half score, away team
homeRed int
awayRed int
homeYellow int
awayYellow int
homeCorner int
awayCorner int
homeRank stringThe ranking of the team in the league, home team
awayRank stringThe ranking of the team in the league, away team
season stringe.g. 2019-2020
stageId stringTo distinguish the different stages of the cup, the league does not return this data.
round stringLeague round or cup stage, e.g. 10
group stringCup group, e.g. A
location stringe.g. Camp Nou
weather stringe.g. Clear
temperature stringe.g. 14℃~15℃
explain stringSpecial case description of the match, e.g. Match end up with [0-3], due to (Torpedo-MAZ Minsk) withdraw from the match
extraExplain objectReturn to Extra time, Penalty kicks, etc.
kickOff int1: Home kickoff
2: Away kickoff
minute intHow many minutes does the match have in regular time?
homeScore intRegular time score, home team
awayScore intRegular time score, away team
extraTimeStatus int1: Normal matches extratime ends, "extraHomeScore/extraAwayScore" includes the regular time score
2: Special matches (e.g. beach football, indoor football) extratime ends, "extraHomeScore/extraAwayScore" does not include the regular time score
3: The match in extra time
extraHomeScore intExtra time score, home team
extraAwayScore intExtra time score, away team
penHomeScore intPenalty score, home team
penAwayScore intPenalty score, away team
twoRoundsHomeScore int
twoRoundsAwayScore int
winner intWinner of the match
1: Home
2: Away
hasLineup booleanIs there Lineup data?
neutral booleanIs it a neutral venue?

Example Request


Example Response

    This API endpoint returns detailed information of matches. You can use it with the Match Modify Record endpoint.

    Schedule & ResultsiSportsAPI