Teams Last Matches

In this reference page, we demonstrate how you can get the teams' last N matches using our newest soccer API endpoint

Endpoint


Even though using our soccer API you have access to the head 2 head team comparison endpoint where we list the last 6 matches of both teams as well as the last 6 matches between the 2 teams, sometimes you just need the last matches of a single team. For this purpose, we developed and released the team's last matches API endpoint. Through this functionality, you get the flexibility of choosing between 1 and 30 last team matches.


GET:

Parameters


This soccer API endpoint takes only 2 parameters. Both of them are required for the proper functioning of the endpoint. team_id and number.


NameTypeRequiredExampleDescription
team_idnumber119The id of the team which last matches we would like to get.
numbernumber110The number of latest matches that we want. This number needs to be between 1 and 30.

Response


{
    "success": true,
    "data": [
        {
            "id": "195428",
            "date": "2020-03-12",
            "home_name": "LASK",
            "away_name": "Manchester United",
            "score": "0 - 5",
            "ht_score": "0 - 1",
            "ft_score": "0 - 5",
            "et_score": "",
            "league_id": "0",
            "home_id": "653",
            "away_id": "19",
            "competition_id": "245",
            "location": "TGW Arena",
            "scheduled": "17:55",
            "league": [],
            "competition": {
                "id": "245",
                "name": "Europa League"
            },
            "outcomes": {
                "half_time": "2",
                "full_time": "2",
                "extra_time": null
            }
        },
        {
            "id": "195054",
            "date": "2020-03-08",
            "home_name": "Manchester United",
            "away_name": "Manchester City",
            "score": "2 - 0",
            "ht_score": "1 - 0",
            "ft_score": "2 - 0",
            "et_score": "",
            "league_id": "25",
            "home_id": "19",
            "away_id": "12",
            "competition_id": "2",
            "location": "Old Trafford",
            "scheduled": "16:30",
            "league": {
                "id": "25",
                "name": "Premier League",
                "country_id": "19"
            },
            "competition": {
                "id": "2",
                "name": "Premier League"
            },
            "outcomes": {
                "half_time": "1",
                "full_time": "1",
                "extra_time": null
            }
        },
        {
            "id": "194127",
            "date": "2020-03-05",
            "home_name": "Derby County",
            "away_name": "Manchester United",
            "score": "0 - 3",
            "ht_score": "0 - 2",
            "ft_score": "0 - 3",
            "et_score": "",
            "league_id": "248",
            "home_id": "503",
            "away_id": "19",
            "competition_id": "152",
            "location": "Pride Park Stadium",
            "scheduled": "19:45",
            "league": {
                "id": "248",
                "name": "FA Cup",
                "country_id": "19"
            },
            "competition": {
                "id": "152",
                "name": "FA Cup"
            },
            "outcomes": {
                "half_time": "2",
                "full_time": "2",
                "extra_time": null
            }
        }
    ]
}


NameTypeExampleDescription
idnumber127887The id of the match
datedate2020-04-02The date when the match happened
home_namestringLASKThe name of the home team
away_namestringManchester UnitedThe name of the away team
scorestring0 - 5The final score of the match whether after 90 or 120 minutes
ht_scorestring0 - 1The half time score of the match
ft_scorestring0 - 5The full time score of the match
et_scorestringThe extra time score of the match
league_idnumber8The id of the league to which the match belongs. In our soccer API leagues are deprecated we suggest using competitions instead
home_idnumber653The id of the home team
away_idnumber19The id of the away team
competition_idnumber245The id of the competition to which the match belongs
locationstringTWG ArenaThe location where the match was played. It could contain the stadium name, city name, and country name
scheduledtime17:55The start time when the match was expected to start. This field might not reflect the actual start time of the match due to delays.
league.idnumber8The id of the league to which the match belongs. In our soccer API leagues are deprecated we suggest using competitions instead
league.namestringEuropa LeagueThe name of the league to which the match belongs. In our soccer API leagues are deprecated we suggest using competitions instead
league.country_idnumber88The country id of league the league to which the match belongs. In our soccer API leagues are deprecated we suggest using competitions instead
competition.idnumber245The id of the competition to which the match belongs
competition.namestringEuropa LeagueThe name of the competition to which the match belongs
outcomes.half_timestring1Betting outcome of the first half 1, X, or 2
outcomes.full_timestring2Betting outcome of the second half 1, X, or 2
outcomes.extra_timestringXBetting outcome of the extra time 1, X, or 2