Soccer API Tech Docs

Soccer API Team Schedule

Provides the all match list of the team in the active season.

Soccer Team Schedule Request URL

GET

References / Dependencies

Tournament ID The id of the tournament. You can find list of 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

Teams Informations The informations of teams in the tournament. You can find list of the teams from Tournament Teams endpoint

Call Rate / Interval

Recommended API Call Interval: 2 Request / Hour Daily Max API Call: 144 Request

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
teamId	INT	R	{teamId}	The id of the team.

Response Output

[ { "homeTeam": { "name": "Manchester United", "shortName": "MANU", "mediumName": "Man United", "id": 4 }, "awayTeam": { "name": "Manchester City", "shortName": "MCFC", "mediumName": "Man. City", "id": 269 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "info": { "stadium": { "name": "Old Trafford", "id": 5 }, "referee": { "name": "Andre Marriner", "id": 295 } }, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2018/2019 Season", "shortName": "18/19", "id": 37295 }, "round": { "name": "Round 31", "shortName": "W31", "id": 31 }, "playingRound": { "name": "Round 35", "shortName": "W35", "id": 35 }, "date": "24/04/2019 19:00:00", "id": 1307727 }, { "homeTeam": { "name": "Manchester United", "shortName": "MANU", "mediumName": "Man United", "id": 4 }, "awayTeam": { "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "info": { "stadium": { "name": "Old Trafford", "id": 5 }, "referee": { "name": "Martin Atkinson", "id": 288 } }, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2018/2019 Season", "shortName": "18/19", "id": 37295 }, "round": { "name": "Round 36", "shortName": "W36", "id": 36 }, "date": "28/04/2019 15:30:00", "id": 1307778 }, { "homeTeam": { "name": "Huddersfield", "shortName": "HUD", "mediumName": "Huddersfield", "id": 246 }, "awayTeam": { "name": "Manchester United", "shortName": "MANU", "mediumName": "Man United", "id": 4 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "info": { "stadium": { "name": "John Smith's", "id": 548 } }, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2018/2019 Season", "shortName": "18/19", "id": 37295 }, "round": { "name": "Round 37", "shortName": "W37", "id": 37 }, "date": "05/05/2019 13:00:00", "id": 1307787 }, { "homeTeam": { "name": "Manchester United", "shortName": "MANU", "mediumName": "Man United", "id": 4 }, "awayTeam": { "name": "Cardiff", "shortName": "CAR", "mediumName": "Cardiff City", "id": 194 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "info": { "stadium": { "name": "Old Trafford", "id": 5 } }, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2018/2019 Season", "shortName": "18/19", "id": 37295 }, "round": { "name": "Round 38", "shortName": "W38", "id": 38 }, "date": "12/05/2019 14:00:00", "id": 1307798 } ]

Response Output Definitions

match

Data

Type

Example

Description

INT

1307727

The id of the match

date

DATE/STR

24/04/2019 19:00:00

The kick-off date of the match, includes also time

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

Manchester United

The full name of the home/away team

shortName

STR

MANU

The short name of the home/away team

mediumName

STR

Man United

The medium name of the home/away team

INT

The id of the home/away team

score

Data	Type	Example	Description
regular	INT	2	The regular score of the match for home/away team
halfTime	INT	2	The half-time score of the match for home/away team
current	INT	6	The current score of the match (live and post) for home/away team
penalties	INT	3	The penalty score of the match for home/away team
extraTime	INT	1	The extra time score of the match for home/away team

status

Data	Type	Example	Description
name	STR	Full Time	The name of the status
shortName	STR	FT	The short name of the status
id	INT	5	The id of the status

info

stadium

Data	Type	Example	Description
name	STR	Old Trafford	The name of the stadium
id	INT	5	The id of the stadium

referee

Data	Type	Example	Description
name	STR	Andre Marriner	The name of the referee
mediumName	STR	A. Marriner	The medium name of the referee
id	INT	295	The id of the referee

tournament

Data	Type	Example	Description
name	STR	English Premier League	The name of the tournament
shortName	STR	EPL	The short name of the tournament
id	INT	2	The id of the tournament

stage

Data	Type	Example	Description
name	STR	2018/2019 Season	The name of the stage
shortName	STR	18/19	The short name of the stage
id	INT	37295	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 1	The name of the round
shortName	STR	W1	The short name of the round
id	INT	1	The id of the round

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