Soccer API Tech Docs

Search in tech docs

Soccer API Tournament Fixture

Provides the match list of the tournaments and works only for active season

Soccer Tournament Fixture 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

Call Rate / Interval

Recommended API Call Interval: 3 Request / Hour Daily Max API Call: 288 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
tournamentId	INT	R	{tournamentId}	The id of the tournament.

Response Output

sample - 1: English Premier League

[ { "homeTeam": { "name": "Brazil", "shortName": "BRA", "mediumName": "Brazil", "id": 2162 }, "awayTeam": { "name": "Bolivia", "shortName": "BOL", "mediumName": "Bolivya", "id": 11697 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "info": {}, "stage": { "name": "Group A", "shortName": "A", "id": 39251 }, "round": { "name": "Round 1", "shortName": "W1", "id": 1 }, "date": "15/06/2019 00:30:00", "id": 1360605 }, { "homeTeam": { "name": "Venezuela", "shortName": "VEN", "mediumName": "Venezuela", "id": 7491 }, "awayTeam": { "name": "Peru", "shortName": "PER", "mediumName": "Peru", "id": 6652 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "info": {}, "stage": { "name": "Group A", "shortName": "A", "id": 39251 }, "round": { "name": "Round 1", "shortName": "W1", "id": 1 }, "date": "15/06/2019 19:00:00", "id": 1360606 }, { "homeTeam": { "name": "Argentina", "shortName": "ARG", "mediumName": "Argentina", "id": 12120 }, "awayTeam": { "name": "Colombia", "shortName": "COL", "mediumName": "Colombia ", "id": 5918 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "info": {}, "stage": { "name": "Group B", "shortName": "B", "id": 39252 }, "round": { "name": "Round 1", "shortName": "W1", "id": 1 }, "date": "15/06/2019 22:00:00", "id": 1360611 } ]

sample - 2: Copa America

Response Output Definitions

match

Data

Type

Example

Description

INT

1307428

The id of the match.

date

DATE/STR

10/08/2018 19:00:00

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

homeTeam / awayTeam

Data

Type

Example

Description

name

STR

Manchester United

Full name of the home/away team.

shortName

STR

MANU

Short name of the home/away team.

mediumName

STR

Man. United

Medium name of the home/away team.

isNational

STR

false

Determines the team is a club team or a national team.

INT

The id of the home/away.

score

Data	Type	Example	Description
regular	INT	2	The regular score of the match for home/away team
halfTime	INT	1	The half-time score of the match for home/away team
current	INT	2	The current score of the match (live and post) for home/away team
penalties	INT	2	The penalty score of the match for home/away team
extraTime	INT	2	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
id	INT	295	The id of the stadium

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+