Top Disciplinary

At this soccer API documentation page, we show you how you can get the top rudest players for EURO 2020 and Copa America.

This API endpoint will only work for the EURO 2020 and Copa America final tournaments. The example given is from the UEFA Champions League.

Our soccer 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 soccer 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).


GET:

Parameters


The competition top disciplinary player list in our soccer API requires only one parameter called competition_id. Without it the API will return an error with a helpful message.


NameTypeRequiredExampleDescription
competition_idnumber1244The id of the competition which top rude players we are getting.

Response


In the response from this soccer 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 soccer 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 "
                }
            }
        ]
    }
}


NameTypeExampleDescription
red_cardsnumber1The number of red cards that the player has received for the duration of the tournament
yellow_cardsnumber3The number of yellow cards that the player has received for the tournament