Contents
What Sportmonks provides
Each venue record in the Football API v3 includes:
– Venue ID, name, and address
– City name, city ID, and country ID
– Postcode and state (where available)
– Latitude and longitude coordinates
– Seating capacity
– Surface type (e.g. grass, artificial)
– Image path for stadium photography
– national_team flag indicating whether the venue is used as a national team ground
Venue IDs are referenced directly on fixture records, making it straightforward to enrich any fixture response with full stadium details using the venue include.
Endpoints
There are four venue endpoints:
GET All Venues returns every venue available within your subscription.
GET https://api.sportmonks.com/v3/football/venues?api_token=YOUR_TOKEN
GET Venue by ID returns a single venue by its ID. Use this when you already have a venue ID from a fixture response and need the full venue record.
GET https://api.sportmonks.com/v3/football/venues/{venue_id}?api_token=YOUR_TOKEN
GET Venues by Season ID returns all venues used across a given season. This is useful for pre-fetching and caching the full set of stadium records for a league you are covering.
GET https://api.sportmonks.com/v3/football/venues/seasons/{season_id}?api_token=YOUR_TOKEN
GET Venues by Search by Name returns venues matching a name query.
GET https://api.sportmonks.com/v3/football/venues/search/{name}?api_token=YOUR_TOKEN
Includes
Venue records support three includes:
– country — adds the full country object for the venue’s location
– city — adds the full city object
– fixtures — returns the fixtures associated with the venue
Example — retrieving a venue with country and city details:
GET https://api.sportmonks.com/v3/football/venues/{venue_id}?api_token=YOUR_TOKEN&include=country;city
Alternatively, you can retrieve venue data directly from a fixture using the venue include on any fixtures endpoint, rather than making a separate venue request.
What you can build with venue data
– Stadium profiles — create dedicated pages for each ground, displaying name, capacity, surface, location, and photography, covering stadiums across competitions such as the Premier League, Bundesliga, La Liga, Serie A, and Champions League.
– Fixture enrichment — add stadium context to match pages and fixture lists. Use the venue include on fixture requests and avoid separate API calls.
– Interactive maps — use latitude, longitude, city, and country data to plot stadiums on a map. Use these maps for travel planning or fan engagement features.
– Venue-based filtering — use the fixtures include on a venue to get all matches at a specific ground. This is helpful for historical ground stats or home record analysis.
– Season caching — use GET Venues by Season ID at the start of each season to fetch and store all stadium records in one request. This reduces the need to fetch venues individually during the season.
Availability
Venue data is included in all Starter, Growth, Pro, and Enterprise plans. Available venues match the leagues in your subscription. You can explore and test endpoints with the Sportmonks Postman collection or API tester in MySportmonks.
Try it free — all paid plans come with a 14-day free trial. The forever-free plan gives you instant access to the Danish Superliga and Scottish Premiership. No credit card is needed.
FAQs about venues
