🥅Fixture

Fixture

Related endpoints

📡Livescores🥅Fixtures

Fields description

Field	Description	Type
id	Refers the unique id of the fixture	integer
sport_id	Refers to the sport the fixture is played at	integer
league_id	Refers to the league the fixture is played in	integer
season_id	Refers to the seasons the fixture is played in	integer
stage_id	Refers to the stage the fixture is played in	integer
group_id	Refers to the group the fixture is played in	integer / null
aggregate_id	Refers to the aggregate the fixture is played at	integer / null
state_id	Refers to the state the fixture is played at	integer
round_id	Refers to the round the fixture is played at	integer / null
state_id	Refers to the state the fixture is played at	integer
venue_id	Refers to the venue the fixture is played at	integer / null
name	Represents the name of the participants	string / null
starting_at	Datetime object representing the start time	date / null
result_info	Represents the final result info	string / null
leg	Represents the leg of the fixture	string
details	Represents details about the fixture	string / null
length	Length of the fixture (minutes)	integer / null

Include options

sport round stage group aggregate league season venue state weatherReport lineups events timeline comments trends statistics periods participants oddspremiumOdds inplayOdds postmatchNews prematchNews metadata tvStations predictions referees formations ballCoordinates sidelined metadata scores

Sorting options

name starting_at

Fixture entity filters

Query Parameters

Name	Required?	Description
api_token	YES Another option is to provide the API token in the header.	Your unique API token. Ex. ?api_token={{YOURTOKEN}}
include	NO	Enrich the API response with more data by using includes. Ex. &include=participants;events
select	NO	Select specific fields on the base entity
filters	Available on Entity	Filter the API response on multiple related entities. There are static filters and dynamic filters. Please find the possibilities in the Static and Dynamic Filter tab.

Static Filters

Static Filters	Available on Entity	Description	Example
ParticipantSearch	Fixture	Filter on the matches of specific participants.	&include=participants&filters=participantSearch:{Celtic}
TodayDate	Fixture	Filter all fixtures to find only the fixtures of today.	&filters=todayDate
Venues	Fixture	Find all fixtures that are played in a specific venue.	&include=venue&filters=venues:{venueIDs} &include=venue&filters=venues:10,12
Deleted	Fixture	Filter on deleted fixtures only. This filter helps to keep your database in sync.	&filters=IsDeleted
IdAfter	All	Filter all fixtures starting from a certain fixture ID. Handy when you are only interested in the most recent fixtures.	&filters=IdAfter:{fixtureID} &filters=IdAfter:18535487
Markets	Odds	Filter the odds on a selection of markets separated by a comma.	&include=odds&filters=markets:{marketIDs} &include=odds&filters=markets:{12,14}
Bookmakers	Odds	Filter the odds on a selection of bookmakers separated by a comma. (e.g: 12,24).	&include=odds&filters=bookmakers:{bookmakerIDs} &include=odds&filters=bookmakers:2,14
WinningOdds	Odds	Filter all winning odds.	&include=odds&filters=WinningOdds

Dynamic Filters

Dynamic Filters	Available on Entity	Description	Examples
types	Statistics, Events, Lineup, Metadata, Periods, Predictability, Predictions, Sidelined, States, Trends	Filter the Types on a selection of Fixture statistics separated by a comma. Filter on the specific trends you want to show.	&include=statistics&filters=statisticTypes:42,49 &include=events&filters=eventTypes:14
states	Fixtures	Filter the states of fixtures separated by a comma.	&include=state&filters=fixtureStates:1
leagues	Aggregates, Fixtures, News, Predictability, Rounds, Seasons, Stages, Standings	Filter the fixtures based on leagues and their rounds.	&filters=fixtureLeagues:{leagueID} &filters=roundLeagues:501
groups	Fixtures, Standing, Standing corrections	Filter the fixtures based on groups. Get their fixtures and standings.	&include=group&filters=fixtureGroups:{groupIDs} &include=group&filters=fixtureGroups:246691
countries	Coaches, Leagues, Players, Referees, Standings, Teams, Venues	Filter the coaches, leagues, players and more based on countries.	&include=coaches&filterscoachCountries:1161
seasons	Aggregates, Statistics (players, team, coaches, referees), Rounds, Sidelined, Stages, Standings, Standing Corrections, Topscorers.	Filter statistics, standings and topscorers based on seasons.	&include=season.statistics&filters=seasonStatisticTypes:52

Filters

More information on how to use filters can be found on our tutorials on how to filter. If you want more information on which filters to use you can check out the following endpoint:

https://api.sportmonks.com/v3/my/filters/entity?api_token={{YOURTOKEN}}

Period

Fields description

Field	Description	Type
id	Refers to the unique id of the period	integer
fixture_id	Refers to the fixture related to the period	integer
type_id	Refers to the type of the period	integer
started	UNIX timestamp of when the period started	integer
ended	UNIX timestamp of when the period ended	integer / null
counts_from	Represents the minute the period starts counting from	integer
ticking	Determines if the period is being played at the moment	boolean
sort_order	Represents the sort order of the period	integer
description	Represents the description of the period	string
time_added	Represents the time added to the period	integer / null
period_length	Represents the scheduled length of the period.	integer
minutes	Represents the current minute of the period	integer
seconds	Represents the amount of seconds after the current minute	integer
has_timer	Marks if we have detailed timer information for minutes and seconds available	boolean

Include options

fixture type events timeline statistics

Aggregate

Fields description

Field	Description	Type
id	Refers to the unique id of the aggregate	integer
league_id	Refers to the league of the aggregate	integer
season_id	Refers to the season of the aggregate	integer
stage_id	Refers to the stage the aggregate	integer
name	Represents the name of the aggregate	string
fixture_ids	Represent the fixture id's related to the aggregate	array
result	Represents the final result of the aggregate	string / null
detail	Gives details of the result of the aggregate	string / null
winner_participant_id	Refers to the winner of the aggregate	integer

Include options

stage league season winner

Lineup

Fields description

Field	Description	Type
id	Refers to the unique id of the lineup	integer
sport_id	Refers to the sport of the lineup	integer
fixture_id	Refers to the fixture the lineup is from	integer
player_id	Refers to the player linked to the lineup	integer
team_id	Refers to the team of the lineup	integer
position_id	Refers to the position of the lineup	integer
detailed_position_id	Refers to the detailed position of the lineup	integer / null
formation_field	Represents the lineup's position in the formation	string / null
type_id	Refers to the type of the lineup	integer
jersey_number	Represents the lineup's jersey number	integer
formation_position	Represents the numeric position of the lineup	integer
player_name	Represents the player name of the lineup	string

Include options

fixture player type position detailedPosition details

Sidelined

Fields description

Field	Description	Type
id	Refers to the unique id of the lineup detail object	integer
fixture_id	Refers to the fixture related to the fixture object	integer
sideline_id	Refers to the sideline related to the fixture	integer
participant_id	Refers to the participant related to the fixture	integer

Include options

fixture sideline participant

LineupDetail

Fields description

Field	Description	Type
id	Refers to the unique id of the lineup detail object	integer
fixture_id	Refers to the fixture related to the lineup detail object	integer
player_id	Refers to the player related to the lineup detail object	integer
team_id	Refers to the team related to the lineup detail object	integer
lineup_id	Refers to the lineup related to the lineup detail object	integer
type_id	Refers to the type of the lineup detail object	integer
data	Represents the value of the lineup detail object	object

Include options

fixture type

Event

Fields description

Field	Description	Type
id	Refers to the unique id of the event	integer
fixture_id	Refers to the fixture related to the event	integer
period_id	Refers to the period related to the event	integer
participant_id	Refers to the participant related to the event	integer
type_id	Refers to the type of the event	integer
player_id	Refers to the player related to the event	integer
related_player_id	Refers to the related player of the event	integer / null
player_name	Represents the name of the player	string
related_player_name	Represents the name of the related player	string / null
coach_id	Refers to the coach related to the event	integer
result	Represents the score after the event happened	string / null
info	Represents info about the event	string / null
addition	Represents extra info about the event	string / null
minute	Represents the minute the event occurred	integer
extra_minute	Represents the extra minutes of injury time	integer / null
injured	Determines if the player of substitution event is injured or not	boolean
rescinded	Determines if the card is rescinded by the referee (card events only)	boolean

Delay / Break Timeline Events

Delay and break events (such as hydration breaks) are currently being rolled out to select leagues. Initial coverage includes the FIFA Club World Cup and the FIFA World Cup 2026.

The Sportmonks Football API tracks match delays and scheduled breaks as dedicated timeline events. These cover any stoppage that interrupts normal play, including hydration breaks, cooling breaks, and other delay types.

Each delay or break produces two event types: one to mark when it starts and one to mark when it ends.

DELAY_START

A DELAY_START event is recorded when a delay or break begins.

Field	Description	Type
type_id	132791	integer
section	"timeline"	string
participant_id	The ID of the team the record belongs to	integer
player_id	null in most cases; see injury note below	integer / null
player_name	null in most cases; see injury note below	string / null
injured	null in most cases; true if an injured player is linked	boolean / null
info	Describes the reason for the delay where available, e.g. "Hydration break"	string / null
addition	Sequential label for the delay, e.g. "1st Delay Start"	string
minute	Match minute at which the delay started	integer
extra_minute	Injury-time minute, if applicable	integer / null

DELAY_END

A DELAY_END event is recorded when play resumes after a delay or break.

Field	Description	Type
type_id	132792	integer
section	"timeline"	string
participant_id	The ID of the team the record belongs to	integer
player_id	null	null
player_name	null	null
injured	null	null
info	null	null
addition	Sequential label for the delay, e.g. "1st Delay End"	string
minute	Match minute at which play resumed	integer
extra_minute	Injury-time minute, if applicable	integer / null

Two records per delay

Both DELAY_START and DELAY_END produce one timeline record per participant. For a standard fixture this means you will receive two DELAY_START records and two DELAY_END records for each delay or break - one for each team's participant_id. The minute and addition values are the same across both records for the same delay moment.

When filtering or rendering delay events, group by addition (e.g. "1st Delay Start") rather than by record ID if you need a single display entry per delay.

Injury-related delays

The behaviour described below is still in development and is subject to change.

When a delay is caused by an injury, the DELAY_START record may include details about the affected player. In these cases the following fields can be populated:

• player_id - the ID of the injured player

• player_name - the name of the injured player

• injured - true

These fields are only present on DELAY_START records and only when injury information is available. Always check for null before accessing them.

Example request

GET https://api.sportmonks.com/v3/football/fixtures/19339023
?include=timeline&api_token=YOUR_TOKEN

Example response

The four records below represent a complete hydration break: two DELAY_START records (one per team) followed by two DELAY_END records.

DELAY_START - home team

{
  "id": 156997833,
  "fixture_id": 19339023,
  "period_id": 6134045,
  "participant_id": 18,
  "type_id": 132791,
  "section": "timeline",
  "player_id": null,
  "related_player_id": null,
  "player_name": null,
  "related_player_name": null,
  "result": null,
  "info": "Hydration break",
  "addition": "2nd Delay Start",
  "minute": 26,
  "extra_minute": null,
  "injured": null,
  "on_bench": false,
  "coach_id": null,
  "sub_type_id": null,
  "detailed_period_id": 6134045,
  "rescinded": null,
  "sort_order": 5
}

DELAY_START - away team

{
  "id": 156997834,
  "fixture_id": 19339023,
  "period_id": 6134045,
  "participant_id": 591,
  "type_id": 132791,
  "section": "timeline",
  "player_id": null,
  "related_player_id": null,
  "player_name": null,
  "related_player_name": null,
  "result": null,
  "info": "Hydration break",
  "addition": "2nd Delay Start",
  "minute": 26,
  "extra_minute": null,
  "injured": null,
  "on_bench": false,
  "coach_id": null,
  "sub_type_id": null,
  "detailed_period_id": 6134045,
  "rescinded": null,
  "sort_order": 6
}

DELAY_END - home team

{
  "id": 156997835,
  "fixture_id": 19339023,
  "period_id": 6134045,
  "participant_id": 18,
  "type_id": 132792,
  "section": "timeline",
  "player_id": null,
  "related_player_id": null,
  "player_name": null,
  "related_player_name": null,
  "result": null,
  "info": null,
  "addition": "2nd Delay End",
  "minute": 29,
  "extra_minute": null,
  "injured": null,
  "on_bench": false,
  "coach_id": null,
  "sub_type_id": null,
  "detailed_period_id": 6134045,
  "rescinded": null,
  "sort_order": 7
}

DELAY_END - away team

{
  "id": 156997836,
  "fixture_id": 19339023,
  "period_id": 6134045,
  "participant_id": 591,
  "type_id": 132792,
  "section": "timeline",
  "player_id": null,
  "related_player_id": null,
  "player_name": null,
  "related_player_name": null,
  "result": null,
  "info": null,
  "addition": "2nd Delay End",
  "minute": 29,
  "extra_minute": null,
  "injured": null,
  "on_bench": false,
  "coach_id": null,
  "sub_type_id": null,
  "detailed_period_id": 6134045,
  "rescinded": null,
  "sort_order": 8
}

Both DELAY_START records share the same addition, minute, and info values but carry different participant_id values - one for each team. The info field is only populated on DELAY_START; DELAY_END records always return null for info.

Include options

fixture subType type player relatedPlayer period participant

Formation

Fields description

Field	Description	Type
id	Refers to the unique id of the formation	integer
fixture_id	Refers to the fixture related to the formation	integer
participant_id	Refers to the participant related to the formation	integer
formation	Displays the formation used by the participant	string
location	Displays the location (home/away) of the formation	string

Include options

fixture participant

Score

Fields description

Field	Description	Type
id	Refers to the unique id of the score	integer
fixture_id	Refers to the fixture related to the score	integer
type_id	Refers to the type of the score	integer
participant_id	Refers to the participant related to the score	integer
score	The score object with the goals and the participant (home/away)	object
description	Displays the description of the score (eg. 1ST_HALF)	string

Include options

fixture participant type

BallCoordinate

Fields description

Field	Description	Type
id	Refers to the unique id of the ball coordinate	integer
fixture_id	Refers to the fixture related to the ball coordinate	integer
period_id	Refers to the period related to the ball coordinate	integer
timer	Displays the time of the ball coordinate	string
x	Displays the X-coordinate of the ball coordinate	string
y	Displays the Y-coordinate of the ball coordinate	string

Include options

fixture period