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.

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 "
                }
            }
        ]
    }
}