Recent form
A
GET
/v1/teams/{id}/form
Last N results, home and away split
The last N results with a home and away split, goals for and against, and the market price in each.
Plan
This endpoint needs Archive.
Calling it on a lower plan returns a 403 naming the plan it needs and
a link to pricing, never a bare refusal.
Parameters
team_id
string
path
required
The club id. e.g.
tm_1E5HXK9
last
integer
query
How many recent matches to consider, 1–50. e.g.
10
venue
string
query
Restrict to
home or away matches. Omit for both. e.g. home
Returns
data.team_id
string
Our id for the club.
data.played
integer
Played.
data.record
object
Record.
data.record.won
integer
Won.
data.record.drawn
integer
Drawn.
data.record.lost
integer
Lost.
data.matches
list
Matches counted.
data.matches[].match_id
string
Our id for the match. Stable: what you store today still resolves later.
data.matches[].kickoff_date
string
The kickoff date in UTC, YYYY-MM-DD.
data.matches[].home_team_name
string
The home side's name.
data.matches[].away_team_name
string
The away side's name.
data.matches[].home_goals
integer
The home side's goals: the final score, after extra time where played.
data.matches[].away_goals
integer
The away side's goals: the final score, after extra time where played.
data.matches[].full_time_result
empty in this example
home, draw or away, on the final score.
data.matches[].home_kickoff_price
number
The price for a home win at kickoff, as decimal odds.
meta.data_as_of
string
When the data behind this answer was last brought up to date.
meta.request_id
string
This request's id, to quote to support.
Request
curl "https://api.footballsoccerapi.com/v1/teams/tm_1E5HXK9/form?last=10&venue=home" \ -H "X-API-Key: $FSAPI_KEY"
const res = await fetch("https://api.footballsoccerapi.com/v1/teams/tm_1E5HXK9/form?last=10&venue=home", { headers: { "X-API-Key": process.env.FSAPI_KEY } }); const { data, meta } = await res.json();
import os, requests r = requests.get( "https://api.footballsoccerapi.com/v1/teams/tm_1E5HXK9/form?last=10&venue=home", headers={"X-API-Key": os.environ["FSAPI_KEY"]}, ) data = r.json()["data"]
$ch = curl_init("https://api.footballsoccerapi.com/v1/teams/tm_1E5HXK9/form?last=10&venue=home"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["X-API-Key: {$key}"], ]); $data = json_decode(curl_exec($ch), true)["data"];
Example response
A real row from the archive, fetched when this page rendered. Run it against your own key below.
200 OK
application/json
{
"data": {
"team_id": "tm_1E5HXK9",
"played": 10,
"record": {
"won": 6,
"drawn": 2,
"lost": 2
},
"matches": [
{
"match_id": "mt_28QVFGW",
"kickoff_date": "2026-10-28",
"home_team_name": "Once Caldas",
"away_team_name": "Alianza Valledupar",
"home_goals": 1,
"away_goals": 0,
"full_time_result": null,
"home_kickoff_price": 1.58
},
{
"match_id": "mt_1SGZZ85",
"kickoff_date": "2026-10-28",
"home_team_name": "Hannover 96",
"away_team_name": "1. FC Kaiserslautern",
"home_goals": 0,
"away_goals": 2,
"full_time_result": "away",
"home_kickoff_price": 1.66
},
{
"match_id": "mt_148VSW6",
"kickoff_date": "2026-10-28",
"home_team_name": "Bayern München",
"away_team_name": "1. FC Magdeburg",
"home_goals": 6,
"away_goals": 1,
"full_time_result": "home",
"home_kickoff_price": 1.03
}
]
},
"meta": {
"data_as_of": "2026-10-29T04:32:57Z",
"request_id": "01J9QW3C7M4KX2VB"
}
}
Run it live
Paste your key and fire the real request. The key is kept in this browser only and never sent anywhere but the API.