Top disciplinary
At this football API documentation page, we show you how you can get the top rudest players for EURO 2020 and Copa America.
Our football API product will provide you with the possibility to get the top rudest players at the two major competitions: EURO 2020 and Copa America. The data includes most red and yellow card receivers for the final stages of these two championships.
Endpoint
To get the nastiest players for competition through our football API, all you need to do is to provide the competition ID. If you want to obtain the complete list with competitions so you have all the id
-s at your disposal you can go through our competitions listing API endpoint documentation page. However, for these 2 tournaments, their respective IDs are UEFA EURO 2020 (ID: 387) and Copa America (ID: 271).
Parameters
The competition top disciplinary player list in our football API requires only one parameter called competition_id
. Without it the API will return an error with a helpful message.
Name | Type | Required | Example | Description |
---|---|---|---|---|
competition_id | number | 1 | 244 | The id of the competition which top rude players we are getting. |
Response
In the response from this football API endpoint you will receive the 15 most booked and sent off footballers for the chosen competition_id
(In the example below, we have listed only 5 players for brevity). Also, the example data is taken from the UEFA Champions League, you can use it for testing during development. The actual data provided by this endpoint will only support the two major competitions mentioned above.
Most of the data fields returned by this football API endpoint are exactly the same as the ones in the goalscorers API enpoint. An exception are the fields red_cards
and yellow_cards
that are replacing the goals
and assists
ones. For the explanation on the other fields refer to the documentation of the goalscorers endpoint.
{
"success": true,
"data": {
"competition": {
"id": "244",
"name": "Champions League"
},
"displinary": [
{
"player_id": "2182",
"name": "Arturo Vidal",
"team_id": "81",
"red_cards": "3",
"yellow_cards": "1",
"played": "3",
"competition_id": "244",
"season_id": "8",
"edition_id": "795",
"team": {
"id": "81",
"name": "Inter",
"stadium": "Stadio Giuseppe Meazza",
"location": "Stadio Giuseppe Meazza"
}
},
{
"player_id": "9565",
"name": "Merih Demiral",
"team_id": "79",
"red_cards": "2",
"yellow_cards": "1",
"played": "4",
"competition_id": "244",
"season_id": "8",
"edition_id": "795",
"team": {
"id": "79",
"name": "Juventus",
"stadium": "Allianz Stadium",
"location": "Allianz Stadium"
}
},
{
"player_id": "11425",
"name": "Fred",
"team_id": "19",
"red_cards": "1",
"yellow_cards": "1",
"played": "4",
"competition_id": "244",
"season_id": "8",
"edition_id": "795",
"team": {
"id": "19",
"name": "Manchester United",
"stadium": "Old Trafford",
"location": "Old Trafford"
}
},
{
"player_id": "2924",
"name": "Leonardo Balerdi",
"team_id": "68",
"red_cards": "1",
"yellow_cards": "1",
"played": "4",
"competition_id": "244",
"season_id": "8",
"edition_id": "795",
"team": {
"id": "68",
"name": "Marseille",
"stadium": "Orange V\u00e9lodrome",
"location": "Orange V\u00e9lodrome"
}
},
{
"player_id": "13879",
"name": "Presnel Kimpembe",
"team_id": "59",
"red_cards": "1",
"yellow_cards": "1",
"played": "5",
"competition_id": "244",
"season_id": "8",
"edition_id": "795",
"team": {
"id": "59",
"name": "Paris Saint Germain",
"stadium": "Parc des Princes ",
"location": "Parc des Princes "
}
}
]
}
}
Name | Type | Example | Description |
---|---|---|---|
red_cards | number | 1 | The number of red cards that the player has received for the duration of the tournament |
yellow_cards | number | 3 | The number of yellow cards that the player has received for the tournament |