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

FOOTBALL CLUB STREAKS API

Streaks
Complimentary key

A club's current and longest runs: wins, unbeaten, clean sheets, scoring and failing to score. On the complimentary key it reads this season's Premier League.

GET/v1/clubs/{club_id}/streaks
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/streaks?season=2026
The answer appears below, with its status and time.
curl "https://api.footballapi.org/v1/clubs/cl_4x2bczxvv/streaks?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
matches_consideredintegerMatches counted
currentobjectThe runs going on now
current.wonintegerMatches won
current.unbeatenintegerMatches without losing
current.lostintegerMatches lost
current.without_winintegerMatches without winning
current.clean_sheetintegerMatches without letting one in
current.scoredintegerMatches with a goal
current.failed_to_scoreintegerMatches without scoring
longestobjectThe longest runs in the matches counted
longest.wonintegerMatches won
longest.unbeatenintegerMatches without losing
longest.lostintegerMatches lost
longest.without_winintegerMatches without winning
longest.clean_sheetintegerMatches without letting one in
longest.scoredintegerMatches with a goal
longest.failed_to_scoreintegerMatches without scoring
as_atobjectThe match the runs are counted to
as_at.match_idstringOur id for the match, mt_ and 9 characters, the same in every answer and for good
as_at.kickoff_datestringThe day of kickoff in UTC, YYYY-MM-DD

EXAMPLE ANSWER

200GET /v1/clubs/cl_4x2bczxvv/streaks?season=2026, taken 21 Oct 2026
{
  "data": {
    "club_id": "cl_4x2bczxvv",
    "club_name": "Tottenham",
    "season_start_year": 2026,
    "matches_considered": 15,
    "current": {
      "won": 1,
      "unbeaten": 2,
      "lost": 0,
      "without_win": 0,
      "clean_sheet": 0,
      "scored": 4,
      "failed_to_score": 0
    },
    "longest": {
      "won": 3,
      "unbeaten": 6,
      "lost": 2,
      "without_win": 6,
      "clean_sheet": 2,
      "scored": 6,
      "failed_to_score": 3
    },
    "as_at": {
      "match_id": "mt_95kf4jw9a",
      "kickoff_date": "2026-10-19"
    }
  },
  "meta": {
    "season": "2026/27",
    "request_id": "req_0abc417450e4bf4c"
  }
}

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.
PREVIOUSClub statsNEXTTravel