FOOTBALL API
Sign inRequest a key
The collectionDocumentationMembershipStatusSupport
Sign inRequest a key
Documentation / Clubs

FOOTBALL CLUB TRAVEL API

Travel
Complimentary key

How far a club travels to away matches in a season, and its record at each distance. On the complimentary key it reads this season's Premier League.

GET/v1/clubs/{club_id}/travel
TRY ITComplimentary
Kept in this browser for every docs page. No key yet? Get a free key
GET https://api.footballapi.org/v1/clubs/cl_4x2bczxvv/travel?season=2026
The answer appears below, with its status and time.
curl "https://api.footballapi.org/v1/clubs/cl_4x2bczxvv/travel?season=2026" \
  -H "X-API-Key: your key"

PARAMETERS

club_idrequiredstringA club id from any match, table or club list, such as cl_a7vhnxhhh. In the path.
seasonintegerThe first year of the season: 2026 for 2026/27.From 2015, or the competition's first season

RETURNS

club_idstringOur id for the club, cl_ and 9 characters, the same in every answer and for good
club_namestringThe club
season_start_yearintegerThe first year of the season: 2026 for 2026/27
away_matchesintegerAway matches counted
total_kmintegerKilometres travelled to away matches in all
average_kmintegerKilometres to an away match, on average
furthest_kmintegerThe furthest away trip, in kilometres
by_distancelistThe record at each distance
by_distance[].bandstringThe distance, in words
by_distance[].min_kmintegerThe shortest trip in the band, in kilometres
by_distance[].playedintegerMatches counted
by_distance[].wonintegerMatches won
by_distance[].drawnintegerMatches drawn
by_distance[].lostintegerMatches lost
by_distance[].win_pctintegerShare of the matches won, as a percentage
by_distance[].goals_forintegerGoals scored
by_distance[].goals_againstintegerGoals let in

EXAMPLE ANSWER

200GET /v1/clubs/cl_4x2bczxvv/travel?season=2026, taken 21 Oct 2026, first rows shown
{
  "data": {
    "club_id": "cl_4x2bczxvv",
    "club_name": "Tottenham",
    "season_start_year": 2026,
    "away_matches": 6,
    "total_km": 19072,
    "average_km": 3179,
    "furthest_km": 18333,
    "by_distance": [
      {
        "band": "under 100 km",
        "min_km": 0,
        "played": 2,
        "won": 1,
        "drawn": 0,
        "lost": 1,
        "win_pct": 50,
        "goals_for": 2,
        "goals_against": 4
      },
      {
        "band": "100–300 km",
        "min_km": 100,
        "played": 3,
        "won": 0,
        "drawn": 2,
        "lost": 1,
        "win_pct": 0,
        "goals_for": 2,
        "goals_against": 4
      },
      {
        "band": "300–600 km",
        "min_km": 300,
        "played": 0,
        "won": 0,
        "drawn": 0,
        "lost": 0,
        "win_pct": null,
        "goals_for": 0,
        "goals_against": 0
      }
    ]
  },
  "meta": {
    "season": "2026/27",
    "request_id": "req_45f3206327038e3c"
  }
}

ERRORS

401unauthorizedNo key, or a key we do not know.
400bad_requestA parameter is missing or not in the right form; the message names it.
403upgrade_requiredAnything outside this season's Premier League, on the complimentary key.
404not_foundAn id or competition we do not have.
422unknown_parameterA parameter this endpoint does not take.
429quota_exceededThe day's 50 calls are used, on the complimentary key; they reset at 00:00 UTC.
PREVIOUSStreaksNEXTHead to head