Soccer API Tech Docs

Search in 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 / MinuteRecommended API Call Interval at 1 hour after game end: 12 Request / Hour

IMPORTANT

This 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-3-3", "id": 20 }, "manager": { "name": "Xavier", "surname": "Creus", "knownName": "Xavi", "middleName": "Hernandez", "id": 12590 }, "starting": [ { "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "position": { "name": "Goalkeeper", "shortName": "GK", "tactical": { "name": "Goalkeeper", "shortName": "GK", "id": 1 }, "id": 1 }, "knownName": "Inaki Pena", "knownNameMedium": "I.Pena", "knownNameShort": "Pena", "shirtNumber": 13, "id": 224914 }, { "country": { "name": "Uruguay", "shortName": "URU", "id": 72 }, "position": { "name": "Defender", "shortName": "DF", "tactical": { "name": "Center Back Right", "shortName": "CBR", "id": 6 }, "id": 2 }, "knownName": "Ronald Araujo", "knownNameMedium": "R.Araujo", "knownNameShort": "Araujo", "shirtNumber": 4, "id": 207711 }, { "country": { "name": "Netherlands", "shortName": "NLD", "id": 13 }, "position": { "name": "Midfielder", "shortName": "MF", "tactical": { "name": "Midfielder Center Left", "shortName": "MCL", "id": 14 }, "id": 3 }, "knownName": "Frenkie De Jong", "knownNameMedium": "F.De Jong", "knownNameShort": "De Jong", "shirtNumber": 21, "id": 154954 }, { "country": { "name": "Poland", "shortName": "POL", "id": 42 }, "position": { "name": "Attacker", "shortName": "FW", "tactical": { "name": "Forward Center", "shortName": "FC", "id": 27 }, "id": 4 }, "knownName": "Robert Lewandowski", "knownNameMedium": "R.Lewandowski", "knownNameShort": "Lewandowski", "shirtNumber": 9, "id": 35952 } ], "bench": [ { "country": { "name": "Portugal", "shortName": "PRT", "id": 15 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Joao Cancelo", "knownNameMedium": "J.Cancelo", "knownNameShort": "Cancelo", "shirtNumber": 2, "id": 96451 }, { "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Pedri", "knownNameMedium": "Pedri", "knownNameShort": "Pedri", "shirtNumber": 8, "id": 237395 } ], "name": "Barcelona", "shortName": "FCB", "mediumName": "Barcelona", "id": 414 }, "awayTeam": { "formation": { "name": "4-4-2", "id": 25 }, "manager": { "name": "Marcelino ", "surname": "Toral", "knownName": "Marcelino Garcia", "middleName": "Garcia ", "id": 1464 }, "starting": [ { "country": { "name": "Denmark", "shortName": "DEN", "id": 10 }, "position": { "name": "Goalkeeper", "shortName": "GK", "tactical": { "name": "Goalkeeper", "shortName": "GK", "id": 1 }, "id": 1 }, "knownName": "Filip Jörgensen", "knownNameMedium": "F.Jörgensen", "knownNameShort": "Jörgensen", "shirtNumber": 13, "id": 252750 }, { "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "position": { "name": "Defender", "shortName": "DF", "tactical": { "name": "Left-Back", "shortName": "LB", "id": 3 }, "id": 2 }, "knownName": "Alberto Moreno", "knownNameMedium": "A.Moreno", "knownNameShort": "Moreno", "shirtNumber": 18, "id": 94252 }, { "country": { "name": "Norway", "shortName": "NOR", "id": 12 }, "position": { "name": "Attacker", "shortName": "FW", "tactical": { "name": "Forward Left", "shortName": "FL", "id": 26 }, "id": 4 }, "knownName": "Alexander Sörloth", "knownNameMedium": "A.Sörloth", "knownNameShort": "Sörloth", "shirtNumber": 11, "id": 115224 }, { "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "position": { "name": "Attacker", "shortName": "FW", "tactical": { "name": "Forward Right", "shortName": "FR", "id": 28 }, "id": 4 }, "knownName": "Gerard Moreno", "knownNameMedium": "G.Moreno", "knownNameShort": "Moreno", "shirtNumber": 7, "id": 83742 } ], "bench": [ { "country": { "name": "France", "shortName": "FRA", "id": 9 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Etienne Capoue", "knownNameMedium": "E.Capoue", "knownNameShort": "Capoue", "shirtNumber": 6, "id": 1048 }, { "country": { "name": "Portugal", "shortName": "PRT", "id": 15 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Gonçalo Guedes", "knownNameMedium": "G.Guedes", "knownNameShort": "Guedes", "shirtNumber": 9, "id": 111388 } ], "name": "Villarreal", "shortName": "VLL", "mediumName": "Villarreal", "id": 542 }, "date": "27/01/2024 17:30:00", "id": 1685510, "tournament": { "name": "Spanish La Liga", "shortName": "SP1", "id": 7 }, "stage": { "name": "Season 2023/2024", "shortName": "23/24", "id": 50461 }, "round": { "name": "Round 22", "shortName": "R22", "id": 22 } }

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