FOOTBALL STADIUM API

Ground

Complimentary key

A ground: its city, its country, how many it holds, its surface and how many matches the collection holds there. Every key can call it.

GET/v1/grounds/{ground_id}

TRY ITComplimentary

X-API-Key

Kept in this browser for every docs page. No key yet? Get a free key

ground_idrequired

GET https://api.footballapi.org/v1/grounds/gd_bdv848ber

The answer appears below, with its status and time.

curl "https://api.footballapi.org/v1/grounds/gd_bdv848ber" \
  -H "X-API-Key: your key"

PARAMETERS

ground_idrequiredstringA ground id from the ground list. In the path.

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/gd_bdv848ber, taken 21 Oct 2026

{
  "data": {
    "ground_id": "gd_bdv848ber",
    "ground_name": "MFA Centenary Stadium",
    "city_name": "Ta&apos;Qali",
    "country_name": "Malta",
    "capacity": 2000,
    "surface": "artificial_turf",
    "match_count": 1034
  },
  "meta": {
    "request_id": "req_7b97a5e270a00608"
  }
}

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.

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.

PREVIOUSGrounds NEXTGoals