Soccer API Tech Docs

Search in 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": { "score": { "regular": 5, "halfTime": 2, "current": 5 }, "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Wrexham", "shortName": "WRE", "mediumName": "Wrexham", "id": 391 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "info": {}, "date": "20/07/2023 00:00:00", "id": 1695689, "tournament": { "name": "Friendly Matches", "shortName": "FM", "id": 99 }, "stage": { "name": "Club Matches", "shortName": "CM", "id": 50319 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "awayTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "info": { "stadium": { "name": "Stamford Bridge", "id": 638 }, "referee": { "name": "Anthony Taylor", "id": 329 } }, "date": "13/08/2023 15:30:00", "id": 1683029, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2023/2024 Season", "shortName": "23/24", "id": 50277 }, "round": { "name": "Round 1", "shortName": "R1", "id": 1 } }, { "homeTeam": { "score": { "regular": 3, "halfTime": 1, "current": 3 }, "name": "West Ham United", "shortName": "WHU", "mediumName": "West Ham", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "info": { "stadium": { "name": "London Olympic Stadium", "id": 5701 }, "referee": { "name": "John Brooks", "id": 4044 } }, "date": "20/08/2023 15:30:00", "id": 1683039, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2023/2024 Season", "shortName": "23/24", "id": 50277 }, "round": { "name": "Round 2", "shortName": "R2", "id": 2 } }, { "homeTeam": { "score": { "regular": 3, "halfTime": 1, "current": 3 }, "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Luton", "shortName": "LUT", "mediumName": "Luton", "id": 266 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "info": { "stadium": { "name": "Stamford Bridge", "id": 638 }, "referee": { "name": "Robert Jones", "id": 2986 } }, "date": "25/08/2023 19:00:00", "id": 1683046, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2023/2024 Season", "shortName": "23/24", "id": 50277 }, "round": { "name": "Round 3", "shortName": "R3", "id": 3 } } ]

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+

Table Tennis API+

Tennis API+