Team last matches

  1. Endpoint
  2. Parameters
  3. Response

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

Endpoint


Even though using our football 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 football API endpoint takes only 2 parameters. Both of them are required for the proper functioning of the endpoint. team_id and number.


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

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
away_idnumber19The id of the away team
away_namestringManchester UnitedThe name of the away team
competition.idnumber245The id of the competition to which the match belongs
competition.namestringEuropa LeagueThe name of the competition to which the match belongs
competition_idnumber245The id of the competition to which the match belongs
datedate2020-04-02The date when the match happened
et_scorestringThe extra time score of the match
ft_scorestring0 - 5The full time score of the match
home_idnumber653The id of the home team
home_namestringLASKThe name of the home team
ht_scorestring0 - 1The half time score of the match
idnumber127887The id of the match
league.country_idnumber88The country id of league the league to which the match belongs. In our football API leagues are deprecated we suggest using competitions instead
league.idnumber8The id of the league to which the match belongs. In our football API leagues are deprecated we suggest using competitions instead
league.namestringEuropa LeagueThe name of the league to which the match belongs. In our football API leagues are deprecated we suggest using competitions instead
league_idnumber8The id of the league to which the match belongs. In our football API leagues are deprecated we suggest using competitions instead
locationstringTWG ArenaThe location where the match was played. It could contain the stadium name, city name, and country name
outcomes.extra_timestringXBetting outcome of the extra time 1, X, or 2
outcomes.full_timestring2Betting outcome of the second half 1, X, or 2
outcomes.half_timestring1Betting outcome of the first half 1, X, or 2
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.
scorestring0 - 5The final score of the match whether after 90 or 120 minutes

Didn't find what you need?

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