1 of 2

Team Squads

Since November 2017 we offer the ability to load historical Squads. This means you can retrieve Squads from 2005 onwards, including Player performance of the Games of the requested Season.

GET Team Squad by Team and Season ID

`GET` Team Squad by Team and Season ID

https://soccer.sportmonks.com/api/v2.0/squad/season/{season_ID}/team/{team_ID}

Endpoint details

Authorization

API Key

Pagination

Allowed nested includes

Parameters

Available parameters

include

Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.

Include options

player

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

You can learn more about what includes are and how they work here:

Example response

https://soccer.sportmonks.com/api/v2.0/squad/season/17141/team/53?api_token={API_TOKEN}

    "data": [
        {
            "player_id": 172923,
            "position_id": 1,
            "number": 6,
            "captain": 0,
            "injured": false,
            "minutes": 1620,
            "appearences": 18,
            "lineups": 18,
            "substitute_in": null,
            "substitute_out": null,
            "substitutes_on_bench": 11,
            "goals": null,
            "owngoals": null,
            "assists": null,
            "saves": 39,
            "inside_box_saves": 21,
            "dispossesed": null,
            "interceptions": null,
            "yellowcards": null,
            "yellowred": null,
            "redcards": null,
            "tackles": null,
            "blocks": null,
            "hit_post": null,
            "cleansheets": 7,
            "rating": "6.81",
            "fouls": {
                "committed": null,
                "drawn": 3
            },
            "crosses": {
                "total": null,
                "accurate": null
            },
            "dribbles": {
                "attempts": null,
                "success": null,
                "dribbled_past": null
            },
            "duels": {
                "total": 7,
                "won": 7
            },
            "passes": {
                "total": 455,
                "accuracy": 75,
                "key_passes": null
            },
            "penalties": {
                "won": null,
                "scores": null,
                "missed": null,
                "committed": null,
                "saves": 1
            },
            "shots": {
                "shots_total": null,
                "shots_on_target": null,
                "shots_off_target": null
            }
        },
        {
            "player_id": 173999,
            "position_id": 1,
            "number": 65,
            "captain": 0,
            "injured": false,
            "minutes": 450,
            "appearences": 5,
            "lineups": 5,
            "substitute_in": null,
            "substitute_out": null,
            "substitutes_on_bench": 8,
            "goals": null,
            "owngoals": null,
            "assists": null,
            "saves": 10,
            "inside_box_saves": 7,
            "dispossesed": null,
            "interceptions": null,
            "yellowcards": null,
            "yellowred": null,
            "redcards": null,
            "tackles": null,
            "blocks": null,
            "hit_post": null,
            "cleansheets": 4,
            "rating": "7.20",
            "fouls": {
                "committed": null,
                "drawn": null
            },
            "crosses": {
                "total": null,
                "accurate": null
            },
            "dribbles": {
                "attempts": null,
                "success": null,
                "dribbled_past": null
            },
            "duels": {
                "total": 1,
                "won": 1
            },
            "passes": {
                "total": 91,
                "accuracy": 74,
                "key_passes": null
            },
            "penalties": {
                "won": null,
                "scores": null,
                "missed": null,
                "committed": null,
                "saves": null
            },
            "shots": {
                "shots_total": null,
                "shots_on_target": null,
                "shots_off_target": null
            }
        },

GET Team Squad by Team and Season ID

`GET` Team Squad by Team and Season ID

https://soccer.sportmonks.com/api/v2.0/squad/season/{season_ID}/team/{team_ID}

Endpoint details

Authorization

API Key

Pagination

Allowed nested includes

Parameters

Available parameters

include

Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.

Include options

player

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

You can learn more about what includes are and how they work here:

Includes

Example response

https://soccer.sportmonks.com/api/v2.0/squad/season/17141/team/53?api_token={API_TOKEN}

    "data": [
        {
            "player_id": 172923,
            "position_id": 1,
            "number": 6,
            "captain": 0,
            "injured": false,
            "minutes": 1620,
            "appearences": 18,
            "lineups": 18,
            "substitute_in": null,
            "substitute_out": null,
            "substitutes_on_bench": 11,
            "goals": null,
            "owngoals": null,
            "assists": null,
            "saves": 39,
            "inside_box_saves": 21,
            "dispossesed": null,
            "interceptions": null,
            "yellowcards": null,
            "yellowred": null,
            "redcards": null,
            "tackles": null,
            "blocks": null,
            "hit_post": null,
            "cleansheets": 7,
            "rating": "6.81",
            "fouls": {
                "committed": null,
                "drawn": 3
            },
            "crosses": {
                "total": null,
                "accurate": null
            },
            "dribbles": {
                "attempts": null,
                "success": null,
                "dribbled_past": null
            },
            "duels": {
                "total": 7,
                "won": 7
            },
            "passes": {
                "total": 455,
                "accuracy": 75,
                "key_passes": null
            },
            "penalties": {
                "won": null,
                "scores": null,
                "missed": null,
                "committed": null,
                "saves": 1
            },
            "shots": {
                "shots_total": null,
                "shots_on_target": null,
                "shots_off_target": null
            }
        },
        {
            "player_id": 173999,
            "position_id": 1,
            "number": 65,
            "captain": 0,
            "injured": false,
            "minutes": 450,
            "appearences": 5,
            "lineups": 5,
            "substitute_in": null,
            "substitute_out": null,
            "substitutes_on_bench": 8,
            "goals": null,
            "owngoals": null,
            "assists": null,
            "saves": 10,
            "inside_box_saves": 7,
            "dispossesed": null,
            "interceptions": null,
            "yellowcards": null,
            "yellowred": null,
            "redcards": null,
            "tackles": null,
            "blocks": null,
            "hit_post": null,
            "cleansheets": 4,
            "rating": "7.20",
            "fouls": {
                "committed": null,
                "drawn": null
            },
            "crosses": {
                "total": null,
                "accurate": null
            },
            "dribbles": {
                "attempts": null,
                "success": null,
                "dribbled_past": null
            },
            "duels": {
                "total": 1,
                "won": 1
            },
            "passes": {
                "total": 91,
                "accuracy": 74,
                "key_passes": null
            },
            "penalties": {
                "won": null,
                "scores": null,
                "missed": null,
                "committed": null,
                "saves": null
            },
            "shots": {
                "shots_total": null,
                "shots_on_target": null,
                "shots_off_target": null
            }
        },

Check this endpoint in Postman.