Contents
What Sportmonks provides
Sportmonks provides fixture data across all leagues within your subscription, covering upcoming, live, and completed matches. The base fixture record includes:
– Fixture ID, name, and sport
– League, season, stage, round, and group IDs
– Venue ID and starting datetime (with Unix timestamp)
– Match state via state_id (e.g. not started, in play, half time, full time)
– Result summary string (e.g. “Arsenal won after full-time.”)
– Leg, length, and placeholder flags
– has_odds flag
– last_processed_at timestamp
Beyond the base record, fixtures support one of the largest sets of includes in the API, allowing you to enrich a single fixture response with as much or as little additional data as your use case requires.
Endpoints
There are twelve fixture endpoints covering every common access pattern:
GET All Fixtures returns all fixtures within your subscription.
GET https://api.sportmonks.com/v3/football/fixtures?api_token=YOUR_TOKEN
GET Fixture by ID returns a single fixture by its ID. This is the most commonly used endpoint when you already have a fixture ID and need to enrich it with includes.
GET https://api.sportmonks.com/v3/football/fixtures/{fixture_id}?api_token=YOUR_TOKEN
GET Fixtures by Multiple IDs returns multiple fixtures in a single request.
GET https://api.sportmonks.com/v3/football/fixtures/multi/{fixture_ids}?api_token=YOUR_TOKEN
GET Fixtures by Date returns all fixtures on a given date.
GET https://api.sportmonks.com/v3/football/fixtures/date/{date}?api_token=YOUR_TOKEN
GET Fixtures by Date Range returns all fixtures within a date range.
GET https://api.sportmonks.com/v3/football/fixtures/between/{start_date}/{end_date}?api_token=YOUR_TOKEN
GET Fixtures by Date Range for Team returns fixtures for a specific team within a date range.
GET https://api.sportmonks.com/v3/football/fixtures/between/{start_date}/{end_date}/{team_id}?api_token=YOUR_TOKEN
GET Fixtures by Head-to-Head returns all head-to-head fixtures between two teams.
GET https://api.sportmonks.com/v3/football/fixtures/head-to-head/{team_id_1}/{team_id_2}?api_token=YOUR_TOKEN
GET Fixtures by Search by Name returns fixtures matching a search query against the fixture name.
GET https://api.sportmonks.com/v3/football/fixtures/search/{name}?api_token=YOUR_TOKEN
GET Upcoming Fixtures by Market ID returns upcoming fixtures for which odds are available in a given market.
GET https://api.sportmonks.com/v3/football/fixtures/upcoming/markets/{market_id}?api_token=YOUR_TOKEN
GET Upcoming Fixtures by TV Station ID returns the upcoming fixtures for a given TV station.
GET https://api.sportmonks.com/v3/football/fixtures/upcoming/tv-stations/{tv_station_id}?api_token=YOUR_TOKEN
GET Past Fixtures by TV Station ID returns completed fixtures that were broadcast on a given TV station.
GET https://api.sportmonks.com/v3/football/fixtures/past/tv-stations/{tv_station_id}?api_token=YOUR_TOKEN
GET Latest Updated Fixtures returns all fixtures that have received an update within the last 10 seconds. Use this as an efficient polling mechanism to stay in sync during live match coverage without requesting full fixture lists.
GET https://api.sportmonks.com/v3/football/fixtures/latest?api_token=YOUR_TOKEN
Note: for in-play fixtures, use the livescores endpoints rather than the fixtures endpoints.
Includes
The fixtures endpoint supports a comprehensive set of includes. You can combine as many as your use case requires, separated by semicolons.
Key includes include: participants, scores, events, lineups, statistics, periods, state, venue, round, stage, league, season, coaches, referees, tvStations, odds, premiumOdds, inplayOdds, predictions, trends, timeline, comments, weatherReport, formations, ballCoordinates, xGFixture, pressure, expectedLineups, sidelined, prematchNews, postmatchNews, metadata, aggregate, group.
Example — retrieving a fixture with participants, scores, events, and lineups:
GET https://api.sportmonks.com/v3/football/fixtures/{fixture_id}?api_token=YOUR_TOKEN&include=participants;scores;events;lineups
For production use, request only the includes your application actually needs. Each additional include increases response size and counts towards your rate limit.
What you can build with fixture data
– Match centre pages — combine participants, scores, events, lineups, statistics, and referee includes to build a full post-match or live match view.
– Fixture list and results pages — use the by-date or by-date-range endpoints to display a daily or weekly fixture list with scores and states
– Head-to-head comparison tools — retrieve the full historical record between two teams and surface win/draw/loss splits, goal averages, and recent form.
– Pre-match previews — enrich upcoming fixtures with expected lineups, pre-match news, odds, and sidelined player data.
– Live match tracking — poll the latest updated fixtures endpoint to catch score changes, new events, and state transitions during live matches.
– Betting integrations — use the by-market-id endpoint to surface upcoming fixtures for a specific betting market, enriched with odds, including.
– Broadcast guides — use the by-TV-station endpoints to show which fixtures are airing on a given broadcaster, useful for media or fan apps
Availability
Fixture data is included in all Starter, Growth, Pro, and Enterprise plans. The leagues available to you depend on your plan and the leagues you select. Historical fixtures beyond three seasons are available via the historical data add-on, starting at €29 as a one-time fee for Starter subscribers. Enterprise plans include full historical access by default.
You can explore all fixture endpoints and their includes in the Sportmonks Postman collection or test them using the API tester in MySportmonks.
Try it free; all paid plans include a 14-day free trial, and the forever-free plan gives you immediate access to the Danish Superliga and Scottish Premiership with no credit card required.
FAQs about fixtures
