Top Yellow Cards

GEThttps://devapi.admin.iotait.tech/api/v1/football/players/top-yellow-cards

Players with the most yellow cards in a competition and season.

Open in API explorer
Freshness — cached for 15 minutes. Repeating the same query inside that window is answered from cache in single digit milliseconds, and meta.cache reads HIT.

Query parameters

NameTypeExampleDescription
competitionrequiredinteger100090Competition identifier, from the competitions endpoint.
seasonrequiredinteger2026Season, as a four digit start year.

Example request

Paste this straight into Postman with Import → Raw text.

curl
curl --location --request GET 'https://devapi.admin.iotait.tech/api/v1/football/players/top-yellow-cards?competition=100090&season=2026' \
--header 'Accept: application/json' \
--header 'X-API-Key: api_mart_your_key_here'

Response

json
{
    "success": true,
    "data": [
        {
            "id": 100077,
            "name": "J. Garner",
            "firstname": "James David",
            "lastname": "Garner",
            "age": 24,
            "birth": {
                "date": "2001-03-13",
                "place": "Birkenhead",
                "country": "England"
            },
            "nationality": "England",
            "height": "186",
            "weight": "78",
            "is_injured": false,
            "photo": "https://apinex.iotait.tech/images/players/100077.png",
            "statistics": [
                {
                    "team": {
                        "id": 100038,
                        "name": "Everton",
                        "logo": "https://apinex.iotait.tech/images/teams/100038.png"
                    },
                    "competition": {
                        "id": 100001,
                        "name": "Premier League",
                        "season": 2025,
                        "country": "England",
                        "logo": "https://apinex.iotait.tech/images/competitions/100001.png",
                        "flag": "https://apinex.iotait.tech/images/flags/gb-eng.svg"
                    },
                    "games": {
                        "appearances": 38,
                        "lineups": 38,
                        "minutes": 3426,
                        "number": 37,
                        "position": "Defender",
                        "rating": "7.24",
                        "captain": false
                    },
                    "substitutes": {
                        "in": 0,
                        "out": 1,
                        "bench": 0
                    },
                    "shots": {
                        "total": 34,
                        "on": 14
                    },
                    "goals": {
                        "total": 2,
                        "conceded": 0,
                        "assists": 7,
                        "saves": null
                    },
                    "passes": {
                        "total": 1792,
                        "key": 56,
                        "accuracy": 87
                    },
                    "tackles": {
                        "total": 120,
                        "blocks": 10,
                        "interceptions": 57
                    },
                    "duels": {
                        "total": 341,
                        "won": 209
                    },
                    "dribbles": {
                        "attempts": 34,
                        "success": 18,
                        "past": null
                    },
                    "fouls": {
                        "drawn": 42,
                        "committed": 39
                    },
                    "cards": {
                        "yellow": 12,
                        "yellowred": 0,
                        "red": 0
                    },
                    "penalty": {
                        "won": null,
                        "commited": null,
                        "scored": 0,
                        "missed": 0,
                        "saved": null
                    }
                }
            ]
        }
    ],
    "meta": {
        "results": 20,
        "page": 1,
        "total_pages": 1
    }
}