Soccer API 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": "Brazil", "shortName": "BRE", "id": 45 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Kadu", "knownNameMedium": "Kadu", "knownNameShort": "Kadu", "id": 13247 }, "team": { "name": "Göztepe", "shortName": "GOZ", "mediumName": "Goztepe", "id": 74 }, "matchesStarted": 6, "minutesPlayed": 564, "position": 1, "matchesPlayed": 7, "totalReds": 2, "redsPerMatch": 0.29 }, { "player": { "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Roberto Soldado", "knownNameMedium": "R.Soldado", "knownNameShort": "Soldado", "id": 3001 }, "team": { "name": "Fenerbahce", "shortName": "FB", "mediumName": "Fenerbahce", "id": 2 }, "matchesStarted": 13, "minutesPlayed": 1161, "position": 2, "matchesPlayed": 17, "totalReds": 2, "redsPerMatch": 0.12 }, { "player": { "country": { "name": "Ghana", "shortName": "GHA", "id": 94 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Isaac Sackey", "knownNameMedium": "I.Sackey", "knownNameShort": "Sackey", "id": 104419 }, "team": { "name": "Alanyaspor", "shortName": "ALNY", "mediumName": "Alanyaspor", "id": 13 }, "matchesStarted": 16, "minutesPlayed": 1386, "position": 3, "matchesPlayed": 19, "totalReds": 2, "redsPerMatch": 0.11 }, { "player": { "country": { "name": "Portugal", "shortName": "PRT", "id": 15 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Tiago Lopes", "knownNameMedium": "T.Lopes", "knownNameShort": "Lopes", "id": 99273 }, "team": { "name": "Kayserispor", "shortName": "KYS", "mediumName": "IM Kayserispor", "id": 93 }, "matchesStarted": 26, "minutesPlayed": 2296, "position": 4, "matchesPlayed": 26, "totalReds": 2, "redsPerMatch": 0.08 }, { "player": { "country": { "name": "Brazil", "shortName": "BRE", "id": 45 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Douglas", "knownNameMedium": "Douglas", "knownNameShort": "Douglas", "id": 37424 }, "team": { "name": "Sivasspor", "shortName": "SVS", "mediumName": "Sivasspor ", "id": 129 }, "matchesStarted": 27, "minutesPlayed": 2418, "position": 5, "matchesPlayed": 26, "totalReds": 2, "redsPerMatch": 0.08 }, { "player": { "country": { "name": "Argentina", "shortName": "ARG", "id": 43 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Hector Canteros", "knownNameMedium": "H.Canteros", "knownNameShort": "Canteros", "id": 14071 }, "team": { "name": "Ankaragucu", "shortName": "MKE", "mediumName": "Ankaragucu", "id": 19 }, "matchesStarted": 7, "minutesPlayed": 571, "position": 6, "matchesPlayed": 6, "totalReds": 1, "redsPerMatch": 0.17 }, { "player": { "country": { "name": "Ukraine", "shortName": "UKR", "id": 47 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Evgen Seleznyov", "knownNameMedium": "E.Seleznyov", "knownNameShort": "Seleznyov", "id": 21039 }, "team": { "name": "Akhisarspor", "shortName": "AKH", "mediumName": "Akhisarspor", "id": 11 }, "matchesStarted": 6, "minutesPlayed": 573, "position": 7, "matchesPlayed": 7, "totalReds": 1, "redsPerMatch": 0.14 }, { "player": { "country": { "name": "Slovenia", "shortName": "SLV", "id": 19 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Matic Fink", "knownNameMedium": "M.Fink", "knownNameShort": "Fink", "id": 53388 }, "team": { "name": "Caykur Rizespor", "shortName": "CRZ", "mediumName": "C.Rizespor", "id": 46 }, "matchesStarted": 4, "minutesPlayed": 420, "position": 8, "matchesPlayed": 8, "totalReds": 1, "redsPerMatch": 0.13 }, { "player": { "country": { "name": "Norway", "shortName": "NOR", "id": 12 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Kristian Opseth", "knownNameMedium": "K.Opseth", "knownNameShort": "Opseth", "id": 135923 }, "team": { "name": "B.S.B Erzurum ", "shortName": "BSBE", "mediumName": "B.S.B Erzurum", "id": 15659 }, "matchesStarted": 6, "minutesPlayed": 476, "position": 9, "matchesPlayed": 8, "totalReds": 1, "redsPerMatch": 0.13 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Koray Altınay", "knownNameMedium": "Koray", "knownNameShort": "Koray", "id": 97174 }, "team": { "name": "Caykur Rizespor", "shortName": "CRZ", "mediumName": "C.Rizespor", "id": 46 }, "matchesStarted": 6, "minutesPlayed": 484, "position": 10, "matchesPlayed": 8, "totalReds": 1, "redsPerMatch": 0.13 } ]

sample - 1: Turkish Super League

[ { "player": { "country": { "name": "Jamaica", "shortName": "JAM", "id": 104 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Wes Morgan", "knownNameMedium": "W.Morgan", "knownNameShort": "Morgan", "id": 4964 }, "team": { "name": "Leicester City", "shortName": "LEIC", "mediumName": "Leicester", "id": 260 }, "matchesStarted": 21, "minutesPlayed": 1974, "position": 1, "matchesPlayed": 22, "totalReds": 2, "redsPerMatch": 0.09 }, { "player": { "country": { "name": "Denmark", "shortName": "DEN", "id": 10 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Pierre-Emil Höjbjerg", "knownNameMedium": "P.Höjbjerg", "knownNameShort": "Höjbjerg", "id": 104417 }, "team": { "name": "Southampton", "shortName": "SOT", "mediumName": "Southampton", "id": 355 }, "matchesStarted": 28, "minutesPlayed": 2512, "position": 2, "matchesPlayed": 26, "totalReds": 2, "redsPerMatch": 0.08 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Phil Jagielka", "knownNameMedium": "P.Jagielka", "knownNameShort": "Jagielka", "id": 188 }, "team": { "name": "Everton", "shortName": "EVE", "mediumName": "Everton", "id": 218 }, "matchesStarted": 4, "minutesPlayed": 380, "position": 3, "matchesPlayed": 5, "totalReds": 1, "redsPerMatch": 0.2 }, { "player": { "country": { "name": "Ivory Coast", "shortName": "CIV", "id": 103 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Eric Bailly", "knownNameMedium": "E.Bailly", "knownNameShort": "Bailly", "id": 145345 }, "team": { "name": "Manchester United", "shortName": "MANU", "mediumName": "Man United", "id": 4 }, "matchesStarted": 7, "minutesPlayed": 578, "position": 4, "matchesPlayed": 11, "totalReds": 1, "redsPerMatch": 0.09 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Fabian Delph", "knownNameMedium": "F.Delph", "knownNameShort": "Delph", "id": 6649 }, "team": { "name": "Manchester City", "shortName": "MCFC", "mediumName": "Man. City", "id": 269 }, "matchesStarted": 8, "minutesPlayed": 726, "position": 5, "matchesPlayed": 11, "totalReds": 1, "redsPerMatch": 0.09 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Tom Smith", "knownNameMedium": "T.Smith", "knownNameShort": "Smith", "id": 117563 }, "team": { "name": "Huddersfield", "shortName": "HUD", "mediumName": "Huddersfield", "id": 246 }, "matchesStarted": 11, "minutesPlayed": 988, "position": 6, "matchesPlayed": 11, "totalReds": 1, "redsPerMatch": 0.09 }, { "player": { "country": { "name": "Ireland", "shortName": "IRL", "id": 41 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Robert Brady", "knownNameMedium": "R.Brady", "knownNameShort": "Brady", "id": 74143 }, "team": { "name": "Burnley", "shortName": "BURN", "mediumName": "Burnley", "id": 187 }, "matchesStarted": 5, "minutesPlayed": 626, "position": 7, "matchesPlayed": 14, "totalReds": 1, "redsPerMatch": 0.07 }, { "player": { "country": { "name": "Scotland", "shortName": "SCO", "id": 17 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Kevin McDonald", "knownNameMedium": "K.McDonald", "knownNameShort": "McDonald", "id": 772 }, "team": { "name": "Fulham", "shortName": "FUL", "mediumName": "Fulham", "id": 226 }, "matchesStarted": 10, "minutesPlayed": 859, "position": 8, "matchesPlayed": 15, "totalReds": 1, "redsPerMatch": 0.07 }, { "player": { "country": { "name": "Cameroon", "shortName": "CMR", "id": 32 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Andre Zambo Anguissa", "knownNameMedium": "Zambo Anguissa", "knownNameShort": "Z.Anguissa", "id": 150037 }, "team": { "name": "Fulham", "shortName": "FUL", "mediumName": "Fulham", "id": 226 }, "matchesStarted": 13, "minutesPlayed": 1272, "position": 9, "matchesPlayed": 18, "totalReds": 1, "redsPerMatch": 0.06 }, { "player": { "country": { "name": "Belgium", "shortName": "BEL", "id": 16 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Christian Kabasele", "knownNameMedium": "C.Kabasele", "knownNameShort": "Kabasele", "id": 34390 }, "team": { "name": "Watford", "shortName": "WAT", "mediumName": "Watford", "id": 378 }, "matchesStarted": 18, "minutesPlayed": 1551, "position": 10, "matchesPlayed": 18, "totalReds": 1, "redsPerMatch": 0.06 } ]

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

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