Soccer API Tech Docs

Search in tech docs

Soccer API Match Events All

Provides all the live events of the match.

Soccer Match Events All 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

Match List 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": "Los Angeles Galaxy", "shortName": "LAG", "mediumName": "LA Galaxy", "id": 1864 }, "awayTeam": { "name": "Los Angeles FC", "shortName": "LAFC", "mediumName": "Los Angeles FC", "id": 20053 }, "events": [ { "type": { "name": "Kick Off", "shortName": "", "id": 39 }, "minute": 1, "orderNo": 0, "homeTeamScore": 0, "awayTeamScore": 0, "id": 11336930 }, { "player": { "country": { "name": "Sweden", "shortName": "SWE", "id": 11 }, "knownName": "Zlatan Ibrahimovic", "knownNameMedium": "Z.Ibrahimovic", "knownNameShort": "Ibrahimovic", "shirtNumber": "9", "id": 904 }, "type": { "name": "Offside", "shortName": "", "id": 13 }, "teamId": 1864, "minute": 1, "orderNo": 1, "homeTeamScore": 0, "awayTeamScore": 0, "id": 11336933 }, { "player": { "country": { "name": "Mexico", "shortName": "MEX", "id": 106 }, "knownName": "Carlos Vela", "knownNameMedium": "C.Vela", "knownNameShort": "Vela", "shirtNumber": "10", "id": 346 }, "type": { "name": "Shot on Target", "shortName": "", "id": 15 }, "teamId": 20053, "combineId": "0", "minute": 3, "orderNo": 1, "homeTeamScore": 0, "awayTeamScore": 0, "id": 11336935 }, { "player": { "country": { "name": "Mexico", "shortName": "MEX", "id": 106 }, "knownName": "Carlos Vela", "knownNameMedium": "C.Vela", "knownNameShort": "Vela", "shirtNumber": "10", "id": 346 }, "type": { "name": "Penalty Goal", "shortName": "P", "id": 7 }, "teamId": 20053, "combineId": "135256421318640", "minute": 3, "orderNo": 2, "homeTeamScore": 0, "awayTeamScore": 1, "id": 11336936 }, { "player": { "country": { "name": "Argentina", "shortName": "ARG", "id": 43 }, "knownName": "Favio Alvarez", "knownNameMedium": "F.Alvarez", "knownNameShort": "Alvarez", "shirtNumber": "11", "id": 121353 }, "type": { "name": "Shot on Target", "shortName": "", "id": 15 }, "teamId": 1864, "minute": 6, "orderNo": 0, "homeTeamScore": 0, "awayTeamScore": 1, "id": 11336938 }, { "player": { "country": { "name": "Sweden", "shortName": "SWE", "id": 11 }, "knownName": "Zlatan Ibrahimovic", "knownNameMedium": "Z.Ibrahimovic", "knownNameShort": "Ibrahimovic", "shirtNumber": "9", "id": 904 }, "type": { "name": "Shot on Target", "shortName": "", "id": 15 }, "teamId": 1864, "minute": 6, "orderNo": 1, "homeTeamScore": 0, "awayTeamScore": 1, "id": 11336939 }, { "player": { "country": { "name": "Mexico", "shortName": "MEX", "id": 106 }, "knownName": "Jonathan Dos Santos", "knownNameMedium": "Dos Santos", "knownNameShort": "D.Santos", "shirtNumber": "8", "id": 54750 }, "type": { "name": "Corner", "shortName": "", "id": 12 }, "teamId": 1864, "minute": 29, "orderNo": 0, "homeTeamScore": 1, "awayTeamScore": 1, "id": 11336965 } ], "date": "20/07/2019 02:00:00", "id": 1352564, "tournament": { "name": "American Major League", "shortName": "UML", "id": 44 }, "stage": { "name": "League Season", "shortName": "REG", "id": 39050 }, "round": { "name": "Round 26", "shortName": "W26", "id": 26 } }

Response Output Definitions

match

Data

Type

Example

Description

INT

1352564

The id of the match

date

DATE/STR

20/07/2019 02:00:00

The date of the match

tournament

Data	Type	Example	Description
name	STR	American Major League	The name of the tournament for the match
shortName	STR	MLS	The short name of the tournament for the match
id	INT	44	The id of the tournament for the match

stage

Data	Type	Example	Description
name	STR	League Season	The name of the stage for the match
shortName	STR	REG	The short name of the stage for the match
id	INT	39050	The id of the stage for the match

round

Data	Type	Example	Description
name	STR	Round 26	The name of the round for the match
shortName	STR	W26	The short name of the round for the match
id	INT	26	The id of the round for the match

homeTeam/awayTeam

Data	Type	Example	Description
name	STR	Los Angeles Galaxy	The name of the home/away team for the match
mediumName	STR	LA Galaxy	The short name of the home/away team for the match
shortName	STR	LAG	The short name of the home/away for the match
id	INT	1864	The id of the home/away for the match

events

event

Data

Type

Example

Description

teamId

INT

1864

The team id of the event

combineId

STR

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

STR

The score of the home team at that moment

awayTeamScore

STR

The score of the away team at that moment

INT

11336939

the id of the event

type

Data	Type	Example	Description
name	STR	Shot on Target	The name of the event type
shortName	STR		The short name of the event type
id	INT	15		the id of the event type

player

Data

Type

Example

Description

knownName

STR

Zlatan Ibrahimovic

The known name of the player

knownNameMedium

STR

Z.Ibrahimovic

The medium known name of the player

knownNameShort

STR

Ibrahimovic

The short known name of the player

shirtNumber

INT

The shirt (jersey) number of the player

INT

904

The id of the player

country

Data	Type	Example	Description
name	STR	Sweden	The name of the player's country
shortName	STR	SWE	The short name of the player's country
id	INT	11	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 Events All

Soccer Match Events All 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