Stats FC Dugout - Documentation

Competitions

GET /competitions

Response

Status: 200 OK

{
    "data": [
        {
            "id": 2,
            "name": "Premier League",
            "key": "EPL",
            "region": "England",
            "rounds": [
                {
                    "id": 435,
                    "name": "Premier League",
                    "season": {
                        "id": 10,
                        "name": "2015\/2016"
                    }
                }
            ]
        }
    ]
}

Optional Parameters

Name	Type	Description
`region`	`string`	The region of the competition

Seasons

GET /seasons

Response

Status: 200 OK

{
    "data": [
        {
            "id": 10,
            "name": "2015\/2016"
        }
    ]
}

Fixtures

GET /fixtures

Response

Status: 200 OK

{
    "data": [
        {
            "id": 21159,
            "timestamp": "2015-08-08T14:00:00+0000",
            "competition": {
                "id": 2,
                "name": "Premier League",
                "key": "EPL",
                "region": "England"
            },
            "round": {
                "id": 435,
                "name": "Premier League",
                "season": {
                    "id": 10,
                    "name": "2015\/2016"
                }
            },
            "teams": {
                "home": {
                    "id": 8,
                    "name": "Stoke City",
                    "shortName": "Stoke"
                },
                "away": {
                    "id": 1,
                    "name": "Liverpool",
                    "shortName": "Liverpool"
                }
            },
            "players": {
                "home": [],
                "away": []
            },
            "score": [
                0,
                0
            ],
            "currentState": "HT",
            "events": [
                "cards": [],
                "goals": [],
                "shootout": [],
                "substitutions": []
            ]
        }
    ]
}

Optional Parameters

Name	Type	Description
`season`	`string`	The name of the season the fixtures are in
`season_id`	`integer`	The ID of the season the fixtures are in
`competition`	`string`	The name of the competition the fixtures are in
`competition_id`	`integer`	The ID of the competition the fixtures are in
`competition_key`	`string`	The key of the competition the fixtures are in
`team`	`string`	The name of the home or away team the fixtures are in
`team_id`	`integer`	The ID of the home or away team the fixtures are in
`from`	`string`	The earliest date to return fixtures from. This is a date in ISO 8601 format: `YYYY-MM-DD`
`to`	`string`	The latest date to return fixtures to. This is a date in ISO 8601 format: `YYYY-MM-DD`

At least one of the season or season_id parameters is required.

Possible Values

Name	Type	Values	Description
`currentState`	`string`	`Int.` (Interrupted) `Delayed` (Delayed) `TBA` (Time to be announced) `14:30` (Not started - match start time) `23` (Match in progress - current minute) `HT` (Half time) `FT` (Full time) `P` (Penalty shootout in progress) `ET` (Extra time) `Break Time` (Break time between extra time periods)	The current match state

Results

GET /results

Response

Status: 200 OK

{
    "data": [
        {
            "id": 69540,
            "timestamp": "2016-08-14T15:00:00+0000",
            "competition": {
                "id": 2,
                "name": "Premier League",
                "key": "EPL",
                "region": "England"
            },
            "round": {
                "id": 1044,
                "name": "Premier League",
                "season": {
                    "id": 10,
                    "name": "2016\/2017"
                }
            },
            "teams": {
                "home": {
                    "id": 18,
                    "name": "Arsenal",
                    "shortName": "Arsenal"
                },
                "away": {
                    "id": 1,
                    "name": "Liverpool",
                    "shortName": "Liverpool"
                }
            },
            "players": {
                "home": [
                    {
                        "id": 16976,
                        "number": 33,
                        "position": "GK",
                        "role": "starting",
                        "name": "P. \u010cech"
                    }
                ],
                "away": [
                    {
                        "id": 17018,
                        "number": 22,
                        "position": "GK",
                        "role": "starting",
                        "name": "S. Mignolet"
                    }
                ]
            },
            "score": [
                3,
                4
            ],
            "currentState": "FT",
            "events": {
                "cards": [
                    {
                        "id": 41059,
                        "matchTime": "25'",
                        "type": "card",
                        "subType": "first-yellow",
                        "team": {
                            "id": 1,
                            "name": "Liverpool",
                            "shortName": "Liverpool"
                        },
                        "player": {
                            "id": 17235,
                            "name": "A. Lallana",
                            "position": "MF"
                        }
                    }
                ],
                "goals": [
                    {
                        "id": 160439,
                        "matchTime": "29'",
                        "type": "goal",
                        "subType": null,
                        "team": {
                            "id": 18,
                            "name": "Arsenal",
                            "shortName": "Arsenal"
                        },
                        "player": {
                            "id": 17476,
                            "name": "T. Walcott",
                            "position": "FW"
                        },
                        "assist": {
                            "id": 34666,
                            "name": "A. Iwobi",
                            "position": "FW"
                        }
                    }
                ],
                "shootout": [],
                "substitutions": [
                    {
                        "id": 57247,
                        "matchTime": "60'",
                        "type": "substitution",
                        "subType": null,
                        "team": {
                            "id": 18,
                            "name": "Arsenal",
                            "shortName": "Arsenal"
                        },
                        "playerOff": {
                            "id": 17478,
                            "name": "A. Ramsey",
                            "position": "MF"
                        },
                        "playerOn": {
                            "id": 17480,
                            "name": "S. Cazorla",
                            "position": "MF"
                        }
                    }
                ]
            }
        }
    ]
}

Optional Parameters

Name	Type	Description
`season`	`string`	The name of the season the results are in
`season_id`	`integer`	The ID of the season the results are in
`competition`	`string`	The name of the competition the results are in
`competition_id`	`integer`	The ID of the competition the results are in
`competition_key`	`string`	The key of the competition the results are in
`team`	`string`	The name of the home or away team the results are in
`team_id`	`integer`	The ID of the home or away team the results are in
`from`	`string`	The earliest date to return results from. This is a date in ISO 8601 format: `YYYY-MM-DD`
`to`	`string`	The latest date to return results to. This is a date in ISO 8601 format: `YYYY-MM-DD`

At least one of the season or season_id parameters is required.

At least one of the competition, competition_id or competition_key parameters is required.

Possible Values

Name	Type	Values	Description
`currentState`	`string`	`Postp.` (Postponed) `Aban.` (Abandoned) `Cancl.` (Cancelled) `Susp.` (Suspended) `Delayed` (Delayed) `FT` (Full time) `Pen.` (Match finished after penalty shootout) `AET` (Match finished after extra time) `WO` (Walkover) `Awarded` (Technical loss)	The current match state
`players` `home` `position` `players` `away` `position` `events` `player` `position`	`string`	`GK` `DF` `MF` `FW`	The player's general position
`players` `home` `role` `players` `away` `role`	`string`	`starting` `sub`	The player's role at the start of the match
`events` `type`	`string`	`goal` `card` `substitution` `shootout`	The primary type of the event
`events` `subType`	`string`	`penalty` (relating to `goal` type) `own-goal` (relating to `goal` type) `first-yellow` (relating to `card` type) `second-yellow` (relating to `card` type) `red` (relating to `card` type) `goal` (relating to `shootout` type) `miss` (relating to `shootout` type)	The secondary type of the event

Live

Get a detailed list of all of today's games with live scores and match events, across all competitions.

GET /live

Response

Status: 200 OK

{
    "data": [
        {
            "id": 3389252,
            "timestamp": "2020-09-20T18:00:00+0000",
            "competition": {
                "id": 9,
                "name": "Premier League",
                "key": "EPL",
                "region": "England"
            },
            "round": {
                "id": 807,
                "name": "2020\/2021",
                "season": {
                    "id": 9,
                    "name": "2020\/2021"
                }
            },
            "teams": {
                "home": {
                    "id": 9240,
                    "name": "Leicester City",
                    "shortName": "Leicester"
                },
                "away": {
                    "id": 9072,
                    "name": "Burnley",
                    "shortName": "Burnley"
                }
            },
            "players": {
                "home": [
                    {
                        "id": 2841,
                        "number": 1,
                        "position": "GK",
                        "role": "starting",
                        "name": "K. Schmeichel"
                    },
                    …
                ],
                "away": [
                    {
                        "id": 220636,
                        "number": 1,
                        "position": "GK",
                        "role": "starting",
                        "name": "N. Pope"
                    },
                    …
                ]
            },
            "score": [
                1,
                1
            ],
            "currentState": "HT",
            "events": {
                "cards": [
                    {
                        "id": 36239771,
                        "matchTime": "8'",
                        "type": "card",
                        "subType": "first-yellow",
                        "team": {
                            "id": 9072,
                            "name": "Burnley",
                            "shortName": "Burnley"
                        },
                        "player": {
                            "id": 15915,
                            "name": "J. Rodriguez",
                            "position": "FW"
                        }
                    },
                    {
                        "id": 36239774,
                        "matchTime": "25'",
                        "type": "card",
                        "subType": "first-yellow",
                        "team": {
                            "id": 9240,
                            "name": "Leicester City",
                            "shortName": "Leicester"
                        },
                        "player": {
                            "id": 140912,
                            "name": "N. Mendy",
                            "position": "MF"
                        }
                    }
                ],
                "goals": [
                    {
                        "id": 36239772,
                        "matchTime": "10'",
                        "type": "goal",
                        "subType": null,
                        "team": {
                            "id": 9072,
                            "name": "Burnley",
                            "shortName": "Burnley"
                        },
                        "player": {
                            "id": 76918,
                            "name": "C. Wood",
                            "position": "FW"
                        }
                    },
                    {
                        "id": 36239773,
                        "matchTime": "20'",
                        "type": "goal",
                        "subType": null,
                        "team": {
                            "id": 9240,
                            "name": "Leicester City",
                            "shortName": "Leicester"
                        },
                        "player": {
                            "id": 454522,
                            "name": "H. Barnes",
                            "position": "MF"
                        },
                        "assist": {
                            "id": 297445,
                            "name": "T. Castagne",
                            "position": "DF"
                        }
                    }
                ],
                "shootout": [],
                "substitutions": [
                    {
                        "id": 36239775,
                        "matchTime": "40'",
                        "type": "substitution",
                        "subType": null,
                        "team": {
                            "id": 9072,
                            "name": "Burnley",
                            "shortName": "Burnley"
                        },
                        "playerOff": {
                            "id": 134040,
                            "name": "R. Brady",
                            "position": "MF"
                        },
                        "playerOn": {
                            "id": 2487,
                            "name": "E. Pieters",
                            "position": "DF"
                        }
                    }
                ]
            }
        }
    ]
}

Possible Values

Name	Type	Values	Description
`currentState`	`string`	`Int.` (Interrupted) `Delayed` (Delayed) `TBA` (Time to be announced) `14:30` (Not started - match start time) `23` (Match in progress - current minute) `HT` (Half time) `FT` (Full time) `P` (Penalty shootout in progress) `ET` (Extra time) `Break Time` (Break time between extra time periods) `Postp.` (Postponed) `Aban.` (Abandoned) `Cancl.` (Cancelled) `Susp.` (Suspended) `Delayed` (Delayed) `FT` (Full time) `Pen.` (Match finished after penalty shootout) `AET` (Match finished after extra time) `WO` (Walkover) `Awarded` (Technical loss)	The current match state
`players` `home` `position` `players` `away` `position` `events` `player` `position`	`string`	`GK` `DF` `MF` `FW`	The player's general position
`players` `home` `role` `players` `away` `role`	`string`	`starting` `sub`	The player's role at the start of the match
`events` `type`	`string`	`goal` `card` `substitution` `shootout`	The primary type of the event
`events` `subType`	`string`	`penalty` (relating to `goal` type) `own-goal` (relating to `goal` type) `first-yellow` (relating to `card` type) `second-yellow` (relating to `card` type) `red` (relating to `card` type) `goal` (relating to `shootout` type) `miss` (relating to `shootout` type)	The secondary type of the event

Events

Get a list of events from the previous 48 hours, across all matches.

GET /events

Response

Status: 200 OK

{
    "data": [
        {
            "id": 342777611,
            "matchTime": "63'",
            "type": "goal",
            "subType": null,
            "score": [
                5,
                0
            ],
            "match_id": 3114438,
            "team": {
                "id": 9259,
                "name": "Manchester City",
                "shortName": "Man City"
            },
            "player": {
                "id": 453102,
                "name": "P. Foden",
                "position": "MF"
            },
            "assist": {
                "id": 364017,
                "name": "Gabriel Jesus",
                "position": "FW"
            }
        }
    ]
}

Possible Values

Name	Type	Values	Description
`player` `position` `assist` `position`	`string`	`GK` `DF` `MF` `FW`	The player's general position
`type`	`string`	`goal` `card` `substitution` `shootout`	The primary type of the event
`subType`	`string`	`penalty` (relating to `goal` type) `own-goal` (relating to `goal` type) `first-yellow` (relating to `card` type) `second-yellow` (relating to `card` type) `red` (relating to `card` type) `goal` (relating to `shootout` type) `miss` (relating to `shootout` type)	The secondary type of the event

Standings

GET /standings

Response

Status: 200 OK

{
    "data": [
        {
            "season": {
                "id": 10,
                "name": "2014\/2015"
            },
            "competition": {
                "id": 2,
                "name": "Premier League",
                "key": "EPL",
                "region": "England"
            },
            "group": null,
            "team": {
                "id": 7,
                "name": "Chelsea",
                "shortName": "Chelsea"
            },
            "position": 1,
            "played": 38,
            "wins": 26,
            "draws": 9,
            "losses": 3,
            "for": 73,
            "against": 32,
            "difference": 41,
            "points": 87,
            "notes": "Promotion - Champions League (Group Stage)"
        }
    ]
}

Optional Parameters

Name	Type	Description
`season`	`string`	The name of the season for the standings
`season_id`	`integer`	The ID of the season for the standings
`competition`	`string`	The name of the competition for the standings
`competition_id`	`integer`	The ID of the competition for the standings
`competition_key`	`string`	The key of the competition for the standings

At least one of the season or season_id parameters is required.

Possible Values

Name	Type	Values	Description
`info`	`string`	`top1` `top2` `top3` `top4` `bottom1`	Meta data about the tier of the league position

Top Scorers

GET /top-scorers

Response

Status: 200 OK

{
    "data": [
        {
            "id": 17183,
            "player": {
                "name": "S. Ag\u00c3\u00bcero"
            },
            "team": {
                "name": "Manchester City",
                "shortName": "Man City"
            },
            "goals": 26
        }
    ]
}

Optional Parameters

Name	Type	Description
`season`	`string`	The name of the season the top scorers are from
`season_id`	`integer`	The ID of the season the top scorers are from
`competition`	`string`	The name of the competition the top scorers are from
`competition_id`	`integer`	The ID of the competition the top scorers are from
`competition_key`	`string`	The key of the competition the top scorers are from
`team`	`string`	The name of the home or away team the top scorers are from
`team_id`	`integer`	The ID of the home or away team the top scorers are from

At least one of the season or season_id parameters is required.

At least one of the competition, competition_id, competition_key, team or team_id parameters is required.

Squads

Get the current squads of each team in the response.

GET /squads

Response

Status: 200 OK

{
    "data": [
        {
            "team": {
                "id": 18,
                "name": "Arsenal",
                "shortName": "Arsenal"
            },
            "players": [
                {
                    "id": 17478,
                    "name": "A. Ramsey",
                    "position": "MF"
                }
            ]
        }
    ]
}

Optional Parameters

Name	Type	Description
`season`	`string`	The name of the season
`season_id`	`integer`	The ID of the season
`competition`	`string`	The name of the competition
`competition_id`	`integer`	The ID of the competition
`competition_key`	`string`	The key of the competition
`team`	`string`	The name of the team
`team_id`	`integer`	The ID of the team

At least one of the competition, competition_id, competition_key, team or team_id parameters is required.

Possible Values

Name	Type	Values	Description
`players` `position`	`string`	`GK` `DF` `MF` `FW`	The player's general position