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

FOOTBALL CLUB API

Club
Complimentary keyMCP tool get_club

A club: its ground, its city, where the ground is and how many of its matches the collection holds. On the complimentary key it reads this season's Premier League.

GET/v1/clubs/{club_id}
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
The answer appears below, with its status and time.
curl "https://api.footballapi.org/v1/clubs/cl_4x2bczxvv" \
  -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.

RETURNS

club_idstringOur id for the club, cl_ and 9 characters, the same in every answer and for good
club_namestringThe club
ground_namestringThe ground
city_namestringThe city of the ground
latitudenumberWhere the ground is, north to south
longitudenumberWhere the ground is, east to west
match_countintegerMatches the collection holds

EXAMPLE ANSWER

200GET /v1/clubs/cl_4x2bczxvv, taken 21 Oct 2026
{
  "data": {
    "club_id": "cl_4x2bczxvv",
    "club_name": "Tottenham",
    "ground_name": "Tottenham Hotspur Stadium",
    "city_name": "London",
    "latitude": 51.604444444444,
    "longitude": -0.066388888888889,
    "match_count": 1629
  },
  "meta": {
    "request_id": "req_af1e544332b7cd6d"
  }
}

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.
PREVIOUSClubsNEXTClub matches