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

FOOTBALL STADIUMS API

Grounds
Complimentary key

Every ground in the collection with its city, capacity and surface, by country, surface or size, paged. Every key can call it.

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

PARAMETERS

countrystringOnly this country's grounds, such as England.
surfacestringThe pitch.grass or artificial_turf
min_capacityintegerGrounds holding at least this many.From 0 to 200,000
pageintegerWhich page, from 1.From 1 to 100,000
per_pageintegerRows on a page. Default 100.From 1 to 1,000

RETURNS

ground_idstringOur id for the ground, gd_ and 9 characters
ground_namestringThe ground
city_namestringThe city of the ground
country_namestringThe country, or World or Europe for a tournament
capacityintegerHow many the ground holds
surfacestringThe pitch, such as grass
match_countintegerMatches the collection holds

EXAMPLE ANSWER

200GET /v1/grounds?per_page=2, taken 21 Oct 2026
{
  "data": [
    {
      "ground_id": "gd_bdv848ber",
      "ground_name": "MFA Centenary Stadium",
      "city_name": "Ta'Qali",
      "country_name": "Malta",
      "capacity": 2000,
      "surface": "artificial_turf",
      "match_count": 1034
    },
    {
      "ground_id": "gd_bbba0v2dp",
      "ground_name": "Estadio Nacional de Fútbol",
      "city_name": "Managua",
      "country_name": "Nicaragua",
      "capacity": 20000,
      "surface": "artificial_turf",
      "match_count": 777
    }
  ],
  "meta": {
    "count": 2,
    "total": 11849,
    "next_cursor": null,
    "request_id": "req_ffb51683d404f799"
  }
}

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.
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.
PREVIOUSHead to headNEXTGround