Soccer API Tech Docs

Search in tech docs

Soccer API Leaderboard: Red Cards

Provides the red card list of the tournaments.

Soccer Leaderboard: Red Cards Request URL

GET

References / Dependencies

Tournament ID The id of the tournament. You can find list of tournament from Tournament List 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: 1 Request / Hour Daily Max API Call: 96 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

[ { "player": { "country": { "name": "Romania", "shortName": "ROU", "id": 22 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Alexandru Maxim", "knownNameMedium": "A.Maxim", "knownNameShort": "Maxim", "id": 87693 }, "team": { "name": "Gaziantep FK", "shortName": "GFK", "mediumName": "Gaziantep FK", "id": 67 }, "matchesStarted": 18, "minutesPlayed": 1565, "position": 1, "matchesPlayed": 19, "totalReds": 2, "redsPerMatch": 0.11 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "İsmail Yüksek", "knownNameMedium": "İsmail", "knownNameShort": "İsmail", "id": 222704 }, "team": { "name": "Fenerbahce", "shortName": "FB", "mediumName": "Fenerbahce", "id": 2 }, "matchesStarted": 17, "minutesPlayed": 1526, "position": 2, "matchesPlayed": 20, "totalReds": 2, "redsPerMatch": 0.10 }, { "player": { "country": { "name": "Brazil", "shortName": "BRE", "id": 45 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Joao Figueiredo", "knownNameMedium": "J.Figueiredo", "knownNameShort": "Figueiredo", "id": 176824 }, "team": { "name": "Basaksehir", "shortName": "IBFK", "mediumName": "Basaksehir", "id": 82 }, "matchesStarted": 15, "minutesPlayed": 1448, "position": 3, "matchesPlayed": 21, "totalReds": 2, "redsPerMatch": 0.10 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Mert Hakan Yandaş", "knownNameMedium": "Mert Hakan", "knownNameShort": "Mert Hakan", "id": 102843 }, "team": { "name": "Fenerbahce", "shortName": "FB", "mediumName": "Fenerbahce", "id": 2 }, "matchesStarted": 2, "minutesPlayed": 180, "position": 4, "matchesPlayed": 7, "totalReds": 1, "redsPerMatch": 0.14 }, { "player": { "country": { "name": "Belgium", "shortName": "BEL", "id": 16 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Landry Dimata", "knownNameMedium": "L.Dimata", "knownNameShort": "Dimata", "id": 159118 }, "team": { "name": "Samsunspor", "shortName": "SAMS", "mediumName": "Samsunspor", "id": 126 }, "matchesStarted": 5, "minutesPlayed": 469, "position": 5, "matchesPlayed": 11, "totalReds": 1, "redsPerMatch": 0.09 }, { "player": { "country": { "name": "Portugal", "shortName": "PRT", "id": 15 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Kevin Rodrigues", "knownNameMedium": "K.Rodrigues", "knownNameShort": "K.Rodrigues", "id": 95331 }, "team": { "name": "Adana Demirspor", "shortName": "ADS", "mediumName": "Adana Demir.", "id": 6 }, "matchesStarted": 11, "minutesPlayed": 922, "position": 6, "matchesPlayed": 11, "totalReds": 1, "redsPerMatch": 0.09 }, { "player": { "country": { "name": "Gambia", "shortName": "GMB", "id": 194 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Ali Sowe", "knownNameMedium": "A.Sowe", "knownNameShort": "Sowe", "id": 111735 }, "team": { "name": "Ankaragucu", "shortName": "MKE", "mediumName": "Ankaragucu", "id": 19 }, "matchesStarted": 11, "minutesPlayed": 997, "position": 7, "matchesPlayed": 12, "totalReds": 1, "redsPerMatch": 0.08 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Jerome Opoku", "knownNameMedium": "J.Opoku", "knownNameShort": "Opoku", "id": 238769 }, "team": { "name": "Basaksehir", "shortName": "IBFK", "mediumName": "Basaksehir", "id": 82 }, "matchesStarted": 12, "minutesPlayed": 1080, "position": 8, "matchesPlayed": 12, "totalReds": 1, "redsPerMatch": 0.08 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Goalkeeper", "shortName": "GK", "id": 1 }, "knownName": "Ertaç Özbir", "knownNameMedium": "Ertaç", "knownNameShort": "Ertaç", "id": 40754 }, "team": { "name": "Adana Demirspor", "shortName": "ADS", "mediumName": "Adana Demir.", "id": 6 }, "matchesStarted": 12, "minutesPlayed": 1080, "position": 9, "matchesPlayed": 12, "totalReds": 1, "redsPerMatch": 0.08 }, { "player": { "country": { "name": "Senegal", "shortName": "SEN", "id": 98 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Ousseynou Ba", "knownNameMedium": "O.Ba", "knownNameShort": "Ba", "id": 205067 }, "team": { "name": "Basaksehir", "shortName": "IBFK", "mediumName": "Basaksehir", "id": 82 }, "matchesStarted": 12, "minutesPlayed": 1092, "position": 10, "matchesPlayed": 13, "totalReds": 1, "redsPerMatch": 0.08 } ]

sample - 1: Turkish Super League

[ { "player": { "country": { "name": "Mali", "shortName": "MLİ", "id": 117 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Yves Bissouma", "knownNameMedium": "Y.Bissouma", "knownNameShort": "Bissouma", "id": 183678 }, "team": { "name": "Tottenham Hotspur", "shortName": "TOT", "mediumName": "Tottenham", "id": 373 }, "matchesStarted": 15, "minutesPlayed": 1281, "position": 1, "matchesPlayed": 15, "totalReds": 2, "redsPerMatch": 0.13 }, { "player": { "country": { "name": "Morocco", "shortName": "MAR", "id": 46 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Anass Zaroury", "knownNameMedium": "A.Zaroury", "knownNameShort": "Zaroury", "id": 238793 }, "team": { "name": "Burnley", "shortName": "BURN", "mediumName": "Burnley", "id": 187 }, "matchesStarted": 1, "minutesPlayed": 134, "position": 2, "matchesPlayed": 5, "totalReds": 1, "redsPerMatch": 0.20 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Joe Worrall", "knownNameMedium": "J.Worrall", "knownNameShort": "Worrall", "id": 168734 }, "team": { "name": "Nottingham Forest", "shortName": "NOTF", "mediumName": "Nott. Forest", "id": 282 }, "matchesStarted": 5, "minutesPlayed": 462, "position": 3, "matchesPlayed": 7, "totalReds": 1, "redsPerMatch": 0.14 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Rhian Brewster", "knownNameMedium": "R.Brewster", "knownNameShort": "Brewster", "id": 198179 }, "team": { "name": "Sheffield Utd.", "shortName": "SUTD", "mediumName": "Sheffield Utd", "id": 350 }, "matchesStarted": 2, "minutesPlayed": 201, "position": 4, "matchesPlayed": 8, "totalReds": 1, "redsPerMatch": 0.13 }, { "player": { "country": { "name": "Portugal", "shortName": "PRT", "id": 15 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Fabio Vieira", "knownNameMedium": "F.Vieira", "knownNameShort": "Vieira", "id": 229372 }, "team": { "name": "Arsenal", "shortName": "ARS", "mediumName": "Arsenal", "id": 157 }, "matchesStarted": 2, "minutesPlayed": 247, "position": 5, "matchesPlayed": 8, "totalReds": 1, "redsPerMatch": 0.13 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Reece James", "knownNameMedium": "R.James", "knownNameShort": "James", "id": 203453 }, "team": { "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "matchesStarted": 5, "minutesPlayed": 407, "position": 6, "matchesPlayed": 8, "totalReds": 1, "redsPerMatch": 0.13 }, { "player": { "country": { "name": "Germany", "shortName": "GER", "id": 8 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Mahmoud Dahoud", "knownNameMedium": "M.Dahoud", "knownNameShort": "Dahoud", "id": 119038 }, "team": { "name": "Brighton & Hove Albion", "shortName": "BHA", "mediumName": "Brighton", "id": 182 }, "matchesStarted": 6, "minutesPlayed": 476, "position": 7, "matchesPlayed": 9, "totalReds": 1, "redsPerMatch": 0.11 }, { "player": { "country": { "name": "Portugal", "shortName": "PRT", "id": 15 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Matheus Nunes", "knownNameMedium": "M.Nunes", "knownNameShort": "Nunes", "id": 221898 }, "team": { "name": "Manchester City", "shortName": "MCFC", "mediumName": "Man. City", "id": 269 }, "matchesStarted": 5, "minutesPlayed": 451, "position": 8, "matchesPlayed": 10, "totalReds": 1, "redsPerMatch": 0.10 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Ben Mee", "knownNameMedium": "B.Mee", "knownNameShort": "Mee", "id": 36111 }, "team": { "name": "Brentford", "shortName": "BREN", "mediumName": "Brentford", "id": 181 }, "matchesStarted": 9, "minutesPlayed": 784, "position": 9, "matchesPlayed": 10, "totalReds": 1, "redsPerMatch": 0.10 }, { "player": { "country": { "name": "France", "shortName": "FRA", "id": 9 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Jeanricner Bellegarde", "knownNameMedium": "J.Bellegarde", "knownNameShort": "Bellegarde", "id": 184455 }, "team": { "name": "Wolverhampton", "shortName": "WOL", "mediumName": "Wolves", "id": 388 }, "matchesStarted": 6, "minutesPlayed": 591, "position": 10, "matchesPlayed": 11, "totalReds": 1, "redsPerMatch": 0.09 } ]

sample - 2: English Premier League

Response Output Definitions

leaderboard

Data

Type

Example

Description

matchesStarted

INT

The starting eleven count of the player

minutesPlayed

INT

894

The total minutes of the player

position

INT

The position of the player in the table

matchesPlayed

INT

The total match count of the player

totalReds

INT

The total red count of the player

redsPerMatch

INT

0.6

The red per match ratio of the player

player

Data

Type

Example

Description

knownName

STR

Wes Morgan

The known name of the player

knownNameMedium

STR

W. Morgan

The medium known name of the player

knownNameShort

STR

Morgan

The short known name of the player

INT

4964

The id of the player

country

Data	Type	Example	Description
name	STR	Jamaica	The name of the country
shortName	STR	JAM	The short name of the country
id	INT	104	The id of the country

position

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

team

Data	Type	Example	Description
name	STR	Leicester City	The name of the team
shortName	STR	LEIC	The short name of the team
mediumName	STR	Leicester	The short name of the team
id	INT	260	The id of the team

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 Leaderboard: Red Cards

Soccer Leaderboard: Red Cards Request URL

References / Dependencies

Call Rate / Interval

Request Headers

Request Parameters

Response Output

Response Output Definitions

leaderboard

player

country

position

team