iSports API – Sports API Documentation & Example Responses for Developers

Events

Update Time: 2026-03-04 09:49

Introduction

• This API endpoint returns instant event of football matches, such as goals, yellow and red cards, substitution, etc.

• By default, the data of the match of the current day is returned, ranging from GMT +0 0:00-23:59.

• The event will be added, modified or deleted. Each eventId stands for an event, which will only be added or deleted. You need to synchronize the data with eventId.

Related Plans

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

Request

Path: /sport/football/events
Method: GET
Calls: This interface is limited to 10 second/call;
Recommend Calls: 1 minute/call
Parameters:

Parameter	Value	Required	Description
date	string	false	yyyy-mm-dd, e.g. 2019-08-01, only for the matches in the past one month.
cmd=new	string	false	Return data updated in the last three minutes.

Response

Parameter		Value	Description
matchId		string
events		list
	eventId	string
	minute	string	e.g : 25 When the match is the injury time for the first half, minutes=45 When the match is the injury time for the second half, minutes=90
	type	int	1: Goal 2: Red card 3: Yellow card 7: Penalty scored 8: Own goal 9: Second yellow card 11: Substitution 13: Penalty missed 14:Video Referee (VR Referee)
	playerId	string	Returns playerId of the scorer, substitution on or Yellow/Red card. Return null when the event has no player data.
	playerName	string	Return null when the event has no player data. Returns 2 player when the event includes a goal assist or a substitution. e.g. Diego Tardelli Martins(Assists:Everton Sousa Soares) or Bruno Alves de Souza↑Cicero Dos Santos Bezerra,Didira↓
	assistPlayerId	string	Returns playerId of the assister or substitution off. Return null when the event has no player data.
	overtime	string	Injury time
	homeEvent	boolean	Is it home team event?
penalty		list
	eventId	string
	homeEvent	boolean	Is it home team event?
	playerId	string
	playerName	string
	homeScore	int
	awayScore	int
	missed	boolean	Is it missed?
	oprTime	int	Update time. unix timestamp

Example Request

Example Response

• This API endpoint returns instant event of football matches, such as goals, yellow and red cards, substitution, etc.\n\n • By default, the data of the match of the current day is returned, ranging from GMT +0 0:00-23:59.\n\n • The event will be added, modified or deleted. Each eventId stands for an event, which will only be added or deleted. You need to synchronize the data with eventId.

Contact