Ground profile
F
GET
/v1/grounds/{id}
One ground and how much we hold on it
One ground: name, city, country, capacity, surface, and how many matches in the archive were played there.
Plan
This endpoint needs Free key. It works on the free key, which reads yesterday, today and the fixtures ahead.
Parameters
venue_id
string
path
required
The ground, from
/v1/grounds. e.g. vn_0K7Y8MT
Request
curl "https://api.footballsoccerapi.com/v1/grounds/vn_0K7Y8MT" \ -H "X-API-Key: $FSAPI_KEY"
const res = await fetch("https://api.footballsoccerapi.com/v1/grounds/vn_0K7Y8MT", { headers: { "X-API-Key": process.env.FSAPI_KEY } }); const { data, meta } = await res.json();
import os, requests r = requests.get( "https://api.footballsoccerapi.com/v1/grounds/vn_0K7Y8MT", headers={"X-API-Key": os.environ["FSAPI_KEY"]}, ) data = r.json()["data"]
$ch = curl_init("https://api.footballsoccerapi.com/v1/grounds/vn_0K7Y8MT"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["X-API-Key: {$key}"], ]); $data = json_decode(curl_exec($ch), true)["data"];
Example response
A real row from the archive, fetched when this page rendered. Run it against your own key below.
200 OK
application/json
{
"data": [],
"meta": {
"data_as_of": "2026-09-27T03:47:30Z",
"request_id": "01J9QW3C7M4KX2VB"
}
}
Run it live
Paste your key and fire the real request. The key is kept in this browser only and never sent anywhere but the API.