Team last matches
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.
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
.
Name | Type | Required | Example | Description |
---|---|---|---|---|
number | number | 1 | 10 | The number of latest matches that we want. This number needs to be between 1 and 30. |
team_id | number | 1 | 19 | The 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
}
}
]
}
Name | Type | Example | Description |
---|---|---|---|
away_id | number | 19 | The id of the away team |
away_name | string | Manchester United | The name of the away team |
competition.id | number | 245 | The id of the competition to which the match belongs |
competition.name | string | Europa League | The name of the competition to which the match belongs |
competition_id | number | 245 | The id of the competition to which the match belongs |
date | date | 2020-04-02 | The date when the match happened |
et_score | string | The extra time score of the match | |
ft_score | string | 0 - 5 | The full time score of the match |
home_id | number | 653 | The id of the home team |
home_name | string | LASK | The name of the home team |
ht_score | string | 0 - 1 | The half time score of the match |
id | number | 127887 | The id of the match |
league.country_id | number | 88 | The country id of league the league to which the match belongs. In our football API leagues are deprecated we suggest using competitions instead |
league.id | number | 8 | The id of the league to which the match belongs. In our football API leagues are deprecated we suggest using competitions instead |
league.name | string | Europa League | The name of the league to which the match belongs. In our football API leagues are deprecated we suggest using competitions instead |
league_id | number | 8 | The id of the league to which the match belongs. In our football API leagues are deprecated we suggest using competitions instead |
location | string | TWG Arena | The location where the match was played. It could contain the stadium name, city name, and country name |
outcomes.extra_time | string | X | Betting outcome of the extra time 1, X, or 2 |
outcomes.full_time | string | 2 | Betting outcome of the second half 1, X, or 2 |
outcomes.half_time | string | 1 | Betting outcome of the first half 1, X, or 2 |
scheduled | time | 17:55 | The start time when the match was expected to start. This field might not reflect the actual start time of the match due to delays. |
score | string | 0 - 5 | The final score of the match whether after 90 or 120 minutes |