Soccer API Tech Docs

Search in tech docs

Soccer API Match Event Basic

Provides the basic live events (goals, assists cards, substitutions and statuses) of the match.

Soccer Match Event Basic Request URL

GET

References / Dependencies

Tournament ID The id of the tournament. You can find list of the tournament from Tournament List endpoint

Stage / Round Structure Stage / Round structures change tournament by tournament. You can find the structures with Tournament Id from Tournament Info endpoint

Matches from Fixture Match Ids can be retrieved from The fixture of the tournament. You can find all matches of the tournament from Tournament Fixture endpoint

Matches from Match List Match Ids can be retrieved from The Daily Match List. You can find all matches in 7-days period from Match List endpoint

Call Rate / Interval

Recommended API Call Interval at live: 15 Request / Minute Recommended API Call Interval at 1 hour after game end: 2 Request / Minute Recommended API Call Interval at more than 1 hour after game end: 6 Request / Hour

IMPORTANT

This data can be retrieved for only ± 7 days.
Please, start your requesting when the match is started. The data will be served when the match is started.
Always compare your event id by id on your side when you retrieved the data from endpoints.
- If you can not find the same event id on your side, please delete the event on your side.
- If you find the event id on your side, please always update your event. Because due to some reasons, player name and minute of the event can be changed.

Request Headers

Data	Type	O / R	Example	Description
languageId	INT	R	{languageId}	The id of the language that you select.
Ocp-Apim-Subscription-Key	STR	R	{yourOcp-Apim-Subscription-Key}	Your account key.
Accept	STR	O	application/xml	Selection of data presentation type as XML/JSON.

^*O= Optional, R= Required

Request Parameters

Data	Type	O / R	Example	Description
matchId	INT	R	{matchId}	The id of the match

Response Output

{ "homeTeam": { "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "awayTeam": { "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "events": [ { "type": { "name": "Kick Off", "shortName": "", "id": 39 }, "minute": 1, "orderNo": 0, "homeTeamScore": 0, "awayTeamScore": 0, "id": 11565996 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "knownName": "Trent Alexander-Arnold", "knownNameMedium": "T.Arnold", "knownNameShort": "Arnold", "shirtNumber": "66", "id": 184110 }, "type": { "name": "Goal", "shortName": "", "id": 6 }, "teamId": 265, "combineId": "1507088156200", "minute": 14, "orderNo": 3, "homeTeamScore": 0, "awayTeamScore": 1, "id": 11566208 }, { "player": { "country": { "name": "Egypt", "shortName": "EGY", "id": 31 }, "knownName": "Mohamed Salah", "knownNameMedium": "M.Salah", "knownNameShort": "Salah", "shirtNumber": "11", "id": 85159 }, "type": { "name": "Assist", "shortName": "", "id": 23 }, "teamId": 265, "combineId": "1507088156200", "minute": 14, "orderNo": 4, "homeTeamScore": 0, "awayTeamScore": 1, "id": 11566213 }, { "player": { "country": { "name": "Italy", "shortName": "ITA", "id": 7 }, "knownName": "Emerson", "knownNameMedium": "Emerson", "knownNameShort": "Emerson", "shirtNumber": "33", "id": 89612 }, "type": { "name": "Subbed Out", "shortName": "", "id": 4 }, "teamId": 200, "combineId": "150145", "minute": 15, "orderNo": 2, "homeTeamScore": 0, "awayTeamScore": 1, "id": 11566225 }, { "player": { "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "knownName": "Marcos Alonso", "knownNameMedium": "M.Alonso", "knownNameShort": "M.Alonso", "shirtNumber": "3", "id": 45829 }, "type": { "name": "Subbed In", "shortName": "", "id": 5 }, "teamId": 200, "combineId": "150145", "minute": 15, "orderNo": 3, "homeTeamScore": 0, "awayTeamScore": 1, "id": 11566226 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "knownName": "Fikayo Tomori", "knownNameMedium": "F.Tomori", "knownNameShort": "Tomori", "shirtNumber": "29", "id": 175126 }, "type": { "name": "Yellow Card", "shortName": "", "id": 1 }, "teamId": 200, "minute": 20, "orderNo": 2, "homeTeamScore": 0, "awayTeamScore": 1, "id": 11566302 }, { "player": { "country": { "name": "Brazil", "shortName": "BRE", "id": 45 }, "knownName": "Roberto Firmino", "knownNameMedium": "R.Firmino", "knownNameShort": "Firmino", "shirtNumber": "9", "id": 52487 }, "type": { "name": "Goal", "shortName": "", "id": 6 }, "teamId": 265, "combineId": "20551211253000", "minute": 30, "orderNo": 4, "homeTeamScore": 0, "awayTeamScore": 2, "id": 11566445 }, { "player": { "country": { "name": "Scotland", "shortName": "SCO", "id": 17 }, "knownName": "Andrew Robertson", "knownNameMedium": "A.Robertson", "knownNameShort": "Robertson", "shirtNumber": "26", "id": 98402 }, "type": { "name": "Assist", "shortName": "", "id": 23 }, "teamId": 265, "combineId": "20551211253000", "minute": 30, "orderNo": 5, "homeTeamScore": 0, "awayTeamScore": 2, "id": 11566463 }, { "player": { "country": { "name": "Denmark", "shortName": "DEN", "id": 10 }, "knownName": "Andreas Christensen", "knownNameMedium": "A.Christensen", "knownNameShort": "Christensen", "shirtNumber": "4", "id": 112327 }, "type": { "name": "Subbed Out", "shortName": "", "id": 4 }, "teamId": 200, "combineId": "422750", "minute": 42, "orderNo": 1, "homeTeamScore": 0, "awayTeamScore": 2, "id": 11566660 }, { "player": { "country": { "name": "France", "shortName": "FRA", "id": 9 }, "knownName": "Kurt Zouma", "knownNameMedium": "K.Zouma", "knownNameShort": "Zouma", "shirtNumber": "15", "id": 86273 }, "type": { "name": "Subbed In", "shortName": "", "id": 5 }, "teamId": 200, "combineId": "422750", "minute": 42, "orderNo": 2, "homeTeamScore": 0, "awayTeamScore": 2, "id": 11566661 }, { "type": { "name": "Half Time", "shortName": "", "id": 40 }, "minute": 45, "orderNo": 6, "homeTeamScore": 0, "awayTeamScore": 2, "id": 11566751 }, { "type": { "name": "Start of 2nd Half", "shortName": "", "id": 41 }, "minute": 46, "orderNo": 0, "homeTeamScore": 0, "awayTeamScore": 2, "id": 11566977 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "knownName": "Trent Alexander-Arnold", "knownNameMedium": "T.Arnold", "knownNameShort": "Arnold", "shirtNumber": "66", "id": 184110 }, "type": { "name": "Yellow Card", "shortName": "", "id": 1 }, "teamId": 265, "minute": 57, "orderNo": 1, "homeTeamScore": 0, "awayTeamScore": 2, "id": 11567180 }, { "player": { "country": { "name": "France", "shortName": "FRA", "id": 9 }, "knownName": "N'Golo Kante", "knownNameMedium": "N.Kante", "knownNameShort": "Kante", "shirtNumber": "7", "id": 95285 }, "type": { "name": "Goal", "shortName": "", "id": 6 }, "teamId": 200, "combineId": "205512102243000", "minute": 71, "orderNo": 2, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567381 }, { "player": { "country": { "name": "Senegal", "shortName": "SEN", "id": 98 }, "knownName": "Sadio Mane", "knownNameMedium": "S.Mane", "knownNameShort": "Mane", "shirtNumber": "10", "id": 90877 }, "type": { "name": "Subbed Out", "shortName": "", "id": 4 }, "teamId": 265, "combineId": "713339", "minute": 71, "orderNo": 3, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567395 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "knownName": "James Milner", "knownNameMedium": "J.Milner", "knownNameShort": "J.Milner", "shirtNumber": "7", "id": 235 }, "type": { "name": "Subbed In", "shortName": "", "id": 5 }, "teamId": 265, "combineId": "713339", "minute": 71, "orderNo": 4, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567396 }, { "player": { "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "knownName": "Cesar Azpilicueta", "knownNameMedium": "C.Azpilicueta", "knownNameShort": "Azpilicueta", "shirtNumber": "28", "id": 2885 }, "type": { "name": "Assist", "shortName": "", "id": 23 }, "teamId": 200, "combineId": "205512102243000", "minute": 71, "orderNo": 5, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11571640 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "knownName": "Tammy Abraham", "knownNameMedium": "T.Abraham", "knownNameShort": "Abraham", "shirtNumber": "9", "id": 182407 }, "type": { "name": "Subbed Out", "shortName": "", "id": 4 }, "teamId": 200, "combineId": "774776", "minute": 77, "orderNo": 1, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567465 }, { "player": { "country": { "name": "Belgium", "shortName": "BEL", "id": 16 }, "knownName": "Michy Batshuayi", "knownNameMedium": "M.Batshuayi", "knownNameShort": "Batshuayi", "shirtNumber": "23", "id": 78626 }, "type": { "name": "Subbed In", "shortName": "", "id": 5 }, "teamId": 200, "combineId": "774776", "minute": 77, "orderNo": 2, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567466 }, { "player": { "country": { "name": "Brazil", "shortName": "BRE", "id": 45 }, "knownName": "Fabinho", "knownNameMedium": "Fabinho", "knownNameShort": "Fabinho", "shirtNumber": "3", "id": 95467 }, "type": { "name": "Yellow Card", "shortName": "", "id": 1 }, "teamId": 265, "minute": 78, "orderNo": 4, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567486 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "knownName": "Jordan Henderson", "knownNameMedium": "J.Henderson", "knownNameShort": "Henderson", "shirtNumber": "14", "id": 605 }, "type": { "name": "Subbed Out", "shortName": "", "id": 4 }, "teamId": 265, "combineId": "844996", "minute": 84, "orderNo": 1, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567602 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "knownName": "Adam Lallana", "knownNameMedium": "A.Lallana", "knownNameShort": "Lallana", "shirtNumber": "20", "id": 5226 }, "type": { "name": "Subbed In", "shortName": "", "id": 5 }, "teamId": 265, "combineId": "844996", "minute": 84, "orderNo": 2, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567603 }, { "player": { "country": { "name": "Croatia", "shortName": "CRO", "id": 40 }, "knownName": "Mateo Kovacic", "knownNameMedium": "M.Kovacic", "knownNameShort": "Kovacic", "shirtNumber": "17", "id": 77381 }, "type": { "name": "Yellow Card", "shortName": "", "id": 1 }, "teamId": 200, "minute": 84, "orderNo": 5, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567618 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "knownName": "James Milner", "knownNameMedium": "J.Milner", "knownNameShort": "J.Milner", "shirtNumber": "7", "id": 235 }, "type": { "name": "Yellow Card", "shortName": "", "id": 1 }, "teamId": 265, "minute": 86, "orderNo": 2, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567637 }, { "player": { "country": { "name": "Egypt", "shortName": "EGY", "id": 31 }, "knownName": "Mohamed Salah", "knownNameMedium": "M.Salah", "knownNameShort": "Salah", "shirtNumber": "11", "id": 85159 }, "type": { "name": "Subbed Out", "shortName": "", "id": 4 }, "teamId": 265, "combineId": "901196", "minute": 90, "orderNo": 9, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567765 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "knownName": "Joseph Gomez", "knownNameMedium": "J.Gomez", "knownNameShort": "Gomez", "shirtNumber": "12", "id": 142785 }, "type": { "name": "Subbed In", "shortName": "", "id": 5 }, "teamId": 265, "combineId": "901196", "minute": 90, "orderNo": 10, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567766 }, { "player": { "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "knownName": "Marcos Alonso", "knownNameMedium": "M.Alonso", "knownNameShort": "M.Alonso", "shirtNumber": "3", "id": 45829 }, "type": { "name": "Yellow Card", "shortName": "", "id": 1 }, "teamId": 200, "minute": 90, "orderNo": 12, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567809 }, { "type": { "name": "Full Time", "shortName": "", "id": 49 }, "minute": 90, "orderNo": 16, "homeTeamScore": 1, "awayTeamScore": 2, "id": 11567837 } ], "date": "22/09/2019 15:30:00", "id": 1370080, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2019/2020", "shortName": "19/20", "id": 39617 }, "round": { "name": "Round 6", "shortName": "W6", "id": 6 } }

Response Output Definitions

match

Data

Type

Example

Description

INT

1363598

The id of the match

date

DATE/STR

03/04/2019 19:00:00

The date of the match

tournament

Data	Type	Example	Description
name	STR	French Cup	The name of the tournament for the match
shortName	STR	FRC	The short name of the tournament for the match
id	INT	51	The id of the tournament for the match

stage

Data	Type	Example	Description
name	STR	Semi Final	The name of the stage for the match
shortName	STR	SF	The short name of the stage for the match
id	INT	38699	The id of the stage for the match

round

Data	Type	Example	Description
name	STR	Single Game	The name of the round for the match
shortName	STR	SG	The short name of the round for the match
id	INT	209	The id of the round for the match

homeTeam/awayTeam

Data	Type	Example	Description
name	STR	Paris St Germain	The name of the home/away team for the match
mediumName	STR	Paris SG	The short name of the home/away team for the match
shortName	STR	PSG	The short name of the home/away for the match
id	INT	209	The id of the home/away for the match

events

event

Data

Type

Example

Description

teamId

INT

269

The team id of the event

combineId

STR

2092064196304

It means the combination of the two events. Like Goal-Assist and SubsOut-SubIn. You can show combined event by using CombineId

minute

INT

The minute of the event

orderNo

INT

The priority number of the event, if its occured in same minute

homeTeamScore

INT

The score of the home team at that moment

awayTeamScore

INT

The score of the away team at that moment

INT

10609835

the id of the event

type

Data	Type	Example	Description
name	STR	Own Goal	The name of the event type
shortName	STR	OG	The short name of the event type
id	INT	8	the id of the event type

player

Data

Type

Example

Description

knownName

STR

Daniel Alves

The known name of the player

knownNameMedium

STR

D. Alves

The medium known name of the player

knownNameShort

STR

D. Alves

The short known name of the player

shirtNumber

STR

The shirt (jersey) number of the player

INT

788

The id of the player

country

Data	Type	Example	Description
name	STR	Brazil	The name of the player's country
shortName	STR	BRE	The short name of the player's country
id	INT	45	the id of the player's country

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

Soccer API Match Event Basic

Soccer Match Event Basic Request URL

References / Dependencies

Call Rate / Interval

IMPORTANT

Request Headers

Request Parameters

Response Output

Response Output Definitions

match

tournament

stage

round

homeTeam/awayTeam

events

event

type

player

country