Soccer API Tech Docs

Soccer API Match Lineup

Provides the lineups and formations for before the match has started.

Soccer Match Lineup 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 1 hour before kickoff: 1 Request / Minute Recommended API Call Interval at live: 6 Request / Hour Recommended API Call Interval at 1 hour after game end: 12 Request / Hour

IMPORTANT

Match List data can be retrieved for only ± 7 days.
Please, start your requesting 45 or 60 mins before the match is started. Because the lineup is served 45 or 60 mins before the match.
When the match is started, you can stop your requesting after 10 minutes and use larger intervals to not miss any updates if it is available. (E.g. request per 15 mins.)

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": { "formation": { "name": "4-2-3-1", "id": 17 }, "manager": { "name": "Jürgen", "surname": "Klopp", "knownName": "Jürgen Klopp", "middleName": "", "id": 43 }, "starting": [ { "country": { "name": "Brazil", "shortName": "BRE", "id": 45 }, "position": { "name": "Goalkeeper", "shortName": "GK", "tactical": { "name": "Kaleci", "shortName": "GK", "id": 1 }, "id": 1 }, "knownName": "Alisson Becker", "knownNameMedium": "A.Becker", "knownNameShort": "Alisson", "shirtNumber": 13, "id": 112470 }, { "country": { "name": "Netherlands", "shortName": "NLD", "id": 13 }, "position": { "name": "Defender", "shortName": "DF", "tactical": { "name": "Orta Sol Arka", "shortName": "CBL", "id": 4 }, "id": 2 }, "knownName": "Virgil Van Dijk", "knownNameMedium": "Van Dijk", "knownNameShort": "V.Dijk", "shirtNumber": 4, "id": 81227 }, { "country": { "name": "Senegal", "shortName": "SEN", "id": 98 }, "position": { "name": "Midfielder", "shortName": "MF", "tactical": { "name": "Attacking Midfielder Right", "shortName": "AMR", "id": 20 }, "id": 3 }, "knownName": "Sadio Mane", "knownNameMedium": "S.Mane", "knownNameShort": "Mane", "shirtNumber": 10, "id": 90877 }, { "country": { "name": "Egypt", "shortName": "EGY", "id": 31 }, "position": { "name": "Attacker", "shortName": "FW", "tactical": { "name": "İleri Merkez", "shortName": "FC", "id": 27 }, "id": 4 }, "knownName": "Mohamed Salah", "knownNameMedium": "M.Salah", "knownNameShort": "Salah", "shirtNumber": 11, "id": 85159 } ], "bench": [ { "country": { "name": "Croatia", "shortName": "CRO", "id": 40 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Dejan Lovren", "knownNameMedium": "D.Lovren", "knownNameShort": "Lovren", "shirtNumber": 6, "id": 35732 }, { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Daniel Sturridge", "knownNameMedium": "D.Sturridge", "knownNameShort": "Sturridge", "shirtNumber": 15, "id": 500 } ], "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "awayTeam": { "formation": { "name": "4-2-3-1", "id": 17 }, "manager": { "name": "Claude", "surname": "Puel", "knownName": "Claude Puel", "middleName": "", "id": 210 }, "starting": [ { "country": { "name": "Denmark", "shortName": "DEN", "id": 10 }, "position": { "name": "Goalkeeper", "shortName": "GK", "tactical": { "name": "Kaleci", "shortName": "GK", "id": 1 }, "id": 1 }, "knownName": "Kasper Schmeichel", "knownNameMedium": "K.Schmeichel", "knownNameShort": "Schmeichel", "shirtNumber": 1, "id": 376 }, { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Defender", "shortName": "DF", "tactical": { "name": "Orta Sol Arka", "shortName": "CBL", "id": 4 }, "id": 2 }, "knownName": "Harry Maguire", "knownNameMedium": "H.Maguire", "knownNameShort": "Maguire", "shirtNumber": 15, "id": 80599 }, { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Midfielder", "shortName": "MF", "tactical": { "name": "Attacking Midfielder Center", "shortName": "AMC", "id": 19 }, "id": 3 }, "knownName": "James Maddison", "knownNameMedium": "J.Maddison", "knownNameShort": "Maddison", "shirtNumber": 10, "id": 123432 }, { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Attacker", "shortName": "FW", "tactical": { "name": "İleri Merkez", "shortName": "FC", "id": 27 }, "id": 4 }, "knownName": "Jamie Vardy", "knownNameMedium": "J.Vardy", "knownNameShort": "Vardy", "shirtNumber": 9, "id": 86745 } ], "bench": [ { "country": { "name": "Jamaica", "shortName": "JAM", "id": 104 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Wes Morgan", "knownNameMedium": "W.Morgan", "knownNameShort": "Morgan", "shirtNumber": 5, "id": 4964 }, { "country": { "name": "Japan", "shortName": "JAP", "id": 26 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Shinji Okazaki", "knownNameMedium": "S.Okazaki", "knownNameShort": "Okazaki", "shirtNumber": 20, "id": 11352 } ], "name": "Leicester City", "shortName": "LEIC", "mediumName": "Leicester", "id": 260 }, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2018/2019 Season", "shortName": "18/19", "id": 37295 }, "round": { "name": "Round 24", "shortName": "W24", "id": 24 }, "date": "30/01/2019 20:00:00", "id": 1307660 }

Response Output Definitions

match

Data

Type

Example

Description

INT

1307660

The id of the match

date

DATE/STR

30/01/2019 20:00:00

The date of the match

tournament

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

stage

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

round

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

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

Liverpool

The name of the home/away team for the match

mediumName

STR

Liverpool

The short name of the home/away team for the match

shortName

STR

LIV

The short name of the home/away for the match

INT

265

The id of the home/away for the match

formation

Data	Type	Example	Description
id	INT	17	The id of the formation
name	STR	4-2-3-1	The name of the formation

manager

Data	Type	Example	Description
id	INT	43	The id of the home/away manager
name	STR	Jürgen	The first name of the home/away manager
surName	STR	Klopp	The last name of the home/away manager
knownName	STR	Jürgen Klopp	The full name of the home/away manager
middleName	STR		The middle name of the home/away manager

starting

player

Data

Type

Example

Description

INT

90877

The id of the player

knownName

STR

Sadio Mane

The known name of the player

knownNameMedium

STR

S.Mane

The medium known name of the player

knownNameShort

STR

Mane

The short known name of the player

shirtNumber

INT

The shirt(jersey) number of the player

country

Data	Type	Example	Description
id	INT	98	The id of the player's country
name	STR	Senegal	The name of the player's country
shortName	STR	SEN	The short name of the player's country

position

Data

Type

Example

Description

INT

The id of the player's position

name

STR

Midfielder

The name of the player's position

shortName

STR

The short name of the player's position

tactical

Data	Type	Example	Description
id	INT	20	The id of the player's position
name	STR	Attacking Midfielder Right	The name of the player's position
shortName	STR	AMR	The short name of the player's position

bench

player

Data

Type

Example

Description

INT

35732

The id of the player

knownName

STR

Dejan Lovren

The known name of the player

knownNameMedium

STR

D.Lovren

The medium known name of the player

knownNameShort

STR

Lovren

The short known name of the player

shirtNumber

INT

The shirt(jersey) number of the player

country

Data	Type	Example	Description
id	INT	40	The id of the player's country
name	STR	Croatia	The name of the player's country
shortName	STR	CRO	The short name of the player's country

position

Data	Type	Example	Description
id	INT	2	The id of the player's position
name	STR	Defender	The name of the player's position
shortName	STR	DF	The short name of the player's position

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 Lineup

Soccer Match Lineup Request URL

References / Dependencies

Call Rate / Interval

IMPORTANT

Request Headers

Request Parameters

Response Output

Response Output Definitions

match

tournament

stage

round

homeTeam/awayTeam

formation

manager

starting

player

country

position

tactical

bench

player

country

position