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.

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


GET:

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.


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


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

Didn't find what you need?

Do no hesitate to contact us. We will get back to you as soon as possible.