Schedule & Results (Basic)

Update Time: 2022-05-19 14:35

Introduction

This API endpoint returns the basic information of the match. If you need more details, please refer to Schedule & Results. You can use it with the Match Modify Record endpoint.

Tips: You have access to all the football Common API endpoints with any valid paid football plans.

Related Plans

You can use this api by subscribing plans:  Stats,  Live Data,  Odds,  Odds Pro,  Betfair.

Request

  • Path: /sport/football/schedule/basic
  • Method: GET
  • Calls: This interface is limited to 60 second/call; 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.
ParameterValueRequiredDescription
datestringfalseyyyy-MM-dd, e.g. 2019-08-01.
The historical schedule data is limited to query the past month.
leagueIdstringfalse
seasonstringfalseUse with leagueId to get the specified season, e.g. 2018-2019
Return to the current season by default.
matchIdstringfalseSupport querying the current season's matches.

Response

ParameterValueDescription
matchId string
leagueId string
leagueType int1: League
2: Cup
leagueName stringFull name, e.g. Brazil Serie A
leagueShortName stringShort name, e.g. BRA D1
leagueColor string
matchTime intMatch scheduled time, 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 int
awayHalfScore int
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
neutral booleanIs it a neutral venue?

Example Request

Example Response

{}
    This API endpoint returns the basic information of the match. If you need more details, please refer to Schedule & Results. You can use it with the Match Modify Record endpoint.\n\n Tips: You have access to all the football Common API endpoints with any valid paid football plans.

    Schedule & Results (Basic)iSportsAPI

    Contact