Use Sportmonks to query sports and reference data.

• Football: fixtures, livescores, leagues, seasons, stages, rounds, teams, squads, players, coaches, referees, venues, standings, topscorers, transfers, schedules, commentaries, TV stations, rivals, expected goals (xG), and predictions.
• Motorsport: sessions, drivers, teams, championship standings, laps, and pitstops.
• Odds: pre-match and in-play odds, bookmakers, and markets.
• Reference data: continents, countries, regions, cities, types, and time zones.

Use include to retrieve supported related data, such as statistics or match details. Available leagues, datasets, and related entities depend on your Sportmonks subscription; an operation's presence in Sim does not grant provider access.

Use the block

Query data across the Sportmonks APIs. Football: fixtures, livescores, leagues, seasons, stages, rounds, teams, squads, players, coaches, referees, venues, standings, topscorers, transfers, schedules, commentaries, TV stations, rivals, expected goals (xG), and predictions. Motorsport: sessions, drivers, teams, championship standings, laps, and pitstops. Odds: pre-match and in-play odds, bookmakers, and markets. Core: continents, countries, regions, cities, types, and time zones.

Actions

Football

Get Expected xG by Player

Retrieve lineup-level expected goals (xG) values per player from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixture;player;team;type)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
expected	array	Array of player-level expected goals (xG) entries
↳ id	number	Unique id of the expected value
↳ fixture_id	number	Fixture related to the value
↳ player_id	number	Player related to the value
↳ team_id	number	Team related to the value
↳ lineup_id	number	Lineup record the player relates to
↳ type_id	number	Type of the expected value
↳ data	object	The expected value payload
↳ value	number	The xG value

Get Expected xG by Team

Retrieve fixture-level expected goals (xG) values per team from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixture;participant;type)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
expected	array	Array of team-level expected goals (xG) entries
↳ id	number	Unique id of the expected value
↳ fixture_id	number	Fixture related to the value
↳ type_id	number	Type of the expected value
↳ participant_id	number	Team related to the expected value
↳ data	object	The expected value payload
↳ value	number	The xG value
↳ location	string	Home or away

Get All Commentaries

Retrieve all textual commentaries available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixture;player)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
commentaries	array	Array of commentary entries
↳ id	number	Unique id of the commentary
↳ fixture_id	number	Fixture related to the commentary
↳ comment	string	The commentary text
↳ minute	number	Match minute of the comment
↳ extra_minute	number	Extra (injury) minute of the comment
↳ is_goal	boolean	Whether the comment is a goal
↳ is_important	boolean	Whether the comment is important
↳ order	number	Order of the comment

Get All Fixtures

Retrieve all football fixtures available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of fixture objects
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get All Players

Retrieve all football players available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. nationality;position)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order players by id (asc or desc)

Output

Parameter	Type	Description
players	array	Array of player objects
↳ id	number	Unique id of the player
↳ sport_id	number	Sport of the player
↳ country_id	number	Country of birth of the player
↳ nationality_id	number	Nationality of the player
↳ city_id	number	City of birth of the player
↳ position_id	number	Position of the player
↳ detailed_position_id	number	Detailed position of the player
↳ type_id	number	Type of the player
↳ common_name	string	Name the player is known for
↳ firstname	string	First name of the player
↳ lastname	string	Last name of the player
↳ name	string	Name of the player
↳ display_name	string	Display name of the player
↳ image_path	string	URL to the player headshot
↳ height	number	Height of the player in cm
↳ weight	number	Weight of the player in kg
↳ date_of_birth	string	Date of birth of the player
↳ gender	string	Gender of the player

Get All Rivals

Retrieve all teams with their rivals information from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. team;rival)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
rivals	array	Array of rival relationships
↳ sport_id	number	Sport of the rival
↳ team_id	number	Team the rivalry belongs to
↳ rival_id	number	Rival team id

Get All Teams

Retrieve all football teams available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;venue)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order teams by id (asc or desc)

Output

Parameter	Type	Description
teams	array	Array of team objects
↳ id	number	Unique id of the team
↳ sport_id	number	Sport of the team
↳ country_id	number	Country of the team
↳ venue_id	number	Home venue of the team
↳ gender	string	Gender of the team
↳ name	string	Name of the team
↳ short_code	string	Short code of the team
↳ image_path	string	URL to the team logo
↳ founded	number	Founding year of the team
↳ type	string	Type of the team
↳ placeholder	boolean	Whether the team is a placeholder
↳ last_played_at	string	Date and time of the last played match

Get All Transfer Rumours

Retrieve all transfer rumours available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fromTeam;toTeam)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
transferRumours	array	Array of transfer rumour objects
↳ id	number	Unique id of the transfer rumour
↳ sport_id	number	Sport of the transfer rumour
↳ player_id	number	Player the rumour relates to
↳ position_id	number	Position id of the player
↳ from_team_id	number	Team the player would transfer from
↳ to_team_id	number	Team the player would transfer to
↳ transfer_fee_id	number	Transfer fee id of the rumour
↳ probability	string	Probability of the rumour (e.g. LOW)
↳ source_name	string	Name of the source of the rumour
↳ source_url	string	URL of the source of the rumour
↳ amount	number	Estimated transfer fee amount
↳ currency	string	Currency of the amount
↳ date	string	Date of the rumour
↳ type_id	number	Type of the transfer rumour

Get All Transfers

Retrieve all transfers available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fromTeam;toTeam)
filters	string	No	Filters to apply (e.g. transferTypes:219,220)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
transfers	array	Array of transfer objects
↳ id	number	Unique id of the transfer
↳ sport_id	number	Sport of the transfer
↳ player_id	number	Player who transferred
↳ type_id	number	Type of the transfer
↳ from_team_id	number	Team the player transferred from
↳ to_team_id	number	Team the player transferred to
↳ position_id	number	Position id of the transfer
↳ detailed_position_id	number	Detailed position id of the transfer
↳ date	string	Date of the transfer
↳ career_ended	boolean	Whether the transfer ended the career
↳ completed	boolean	Whether the transfer is completed
↳ amount	number	Transfer fee amount

Get Brackets by Season

Retrieve the knockout-stage tournament bracket (stages and progression edges) for a season ID

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response

Output

Parameter	Type	Description
brackets	json	Bracket object containing stages (fixtures grouped by knockout round) and edges (progression paths between fixtures)

Get Coach by ID

Retrieve a single football coach by their ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
coachId	string	Yes	The unique id of the coach
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;teams;statistics)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
coach	object	The requested coach object
↳ id	number	Unique id of the coach
↳ player_id	number	Player related to the coach
↳ sport_id	number	Sport of the coach
↳ country_id	number	Country of the coach
↳ nationality_id	number	Nationality of the coach
↳ city_id	number	Birth city of the coach
↳ common_name	string	Common name of the coach
↳ firstname	string	First name of the coach
↳ lastname	string	Last name of the coach
↳ name	string	Name of the coach
↳ display_name	string	Display name of the coach
↳ image_path	string	URL to the coach headshot
↳ height	number	Height of the coach in cm
↳ weight	number	Weight of the coach in kg
↳ date_of_birth	string	Date of birth of the coach
↳ gender	string	Gender of the coach

Get Coaches

Retrieve all football coaches available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;teams)
filters	string	No	Filters to apply (e.g. coachCountries:462)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
coaches	array	Array of coach objects
↳ id	number	Unique id of the coach
↳ player_id	number	Player related to the coach
↳ sport_id	number	Sport of the coach
↳ country_id	number	Country of the coach
↳ nationality_id	number	Nationality of the coach
↳ city_id	number	Birth city of the coach
↳ common_name	string	Common name of the coach
↳ firstname	string	First name of the coach
↳ lastname	string	Last name of the coach
↳ name	string	Name of the coach
↳ display_name	string	Display name of the coach
↳ image_path	string	URL to the coach headshot
↳ height	number	Height of the coach in cm
↳ weight	number	Weight of the coach in kg
↳ date_of_birth	string	Date of birth of the coach
↳ gender	string	Gender of the coach

Get Coaches by Country

Retrieve all coaches for a country ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
countryId	string	Yes	The unique id of the country
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;nationality)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
coaches	array	Array of coach objects for the country
↳ id	number	Unique id of the coach
↳ player_id	number	Player related to the coach
↳ sport_id	number	Sport of the coach
↳ country_id	number	Country of the coach
↳ nationality_id	number	Nationality of the coach
↳ city_id	number	Birth city of the coach
↳ common_name	string	Common name of the coach
↳ firstname	string	First name of the coach
↳ lastname	string	Last name of the coach
↳ name	string	Name of the coach
↳ display_name	string	Display name of the coach
↳ image_path	string	URL to the coach headshot
↳ height	number	Height of the coach in cm
↳ weight	number	Weight of the coach in kg
↳ date_of_birth	string	Date of birth of the coach
↳ gender	string	Gender of the coach

Get Commentaries by Fixture

Retrieve textual commentary for a fixture by fixture ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;relatedPlayer)

Output

Parameter	Type	Description
commentaries	array	Array of commentary entries for the fixture
↳ id	number	Unique id of the commentary
↳ fixture_id	number	Fixture related to the commentary
↳ comment	string	The commentary text
↳ minute	number	Match minute of the comment
↳ extra_minute	number	Extra (injury) minute of the comment
↳ is_goal	boolean	Whether the comment is a goal
↳ is_important	boolean	Whether the comment is important
↳ order	number	Order of the comment

Get Current Leagues by Team

Retrieve all current leagues for a team ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;currentSeason)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order leagues (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of current league objects for the team
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	number	Whether the league is active (1) or inactive (0)
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date the last fixture was played
↳ category	number	Importance category of the league (1-4)

Get Expected Lineups by Player

Retrieve the premium expected lineups for a player ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
playerId	string	Yes	The unique id of the player
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fixture)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
expectedLineups	array	Array of expected lineup entries for the player
↳ id	number	Unique id of the expected lineup record
↳ sport_id	number	Sport of the expected lineup
↳ fixture_id	number	Fixture the expected lineup relates to
↳ player_id	number	Player in the expected lineup
↳ team_id	number	Team of the expected lineup player
↳ formation_field	string	Formation field of the player
↳ position_id	number	Position id of the player
↳ detailed_position_id	number	Detailed position id of the player
↳ type_id	number	Type of the expected lineup record
↳ formation_position	number	Position of the player in the formation
↳ player_name	string	Name of the player
↳ jersey_number	number	Jersey number of the player

Get Expected Lineups by Team

Retrieve the premium expected lineups for a team ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fixture)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
expectedLineups	array	Array of expected lineup entries for the team
↳ id	number	Unique id of the expected lineup record
↳ sport_id	number	Sport of the expected lineup
↳ fixture_id	number	Fixture the expected lineup relates to
↳ player_id	number	Player in the expected lineup
↳ team_id	number	Team of the expected lineup player
↳ formation_field	string	Formation field of the player
↳ position_id	number	Position id of the player
↳ detailed_position_id	number	Detailed position id of the player
↳ type_id	number	Type of the expected lineup record
↳ formation_position	number	Position of the player in the formation
↳ player_name	string	Name of the player
↳ jersey_number	number	Jersey number of the player

Get Extended Team Squad

Retrieve all squad entries for a team (based on current seasons) by team ID

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;position)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
squad	array	Array of extended squad entries for the team
↳ id	number	Unique id of the squad record
↳ transfer_id	number	Transfer id of the squad record
↳ player_id	number	Player in the squad
↳ team_id	number	Team of the squad
↳ position_id	number	Position of the player in the squad
↳ detailed_position_id	number	Detailed position of the player in the squad
↳ jersey_number	number	Jersey number of the player
↳ start	string	Start contract date of the player
↳ end	string	End contract date of the player

Get Fixture by ID

Retrieve a single football fixture by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores;events;lineups;statistics)
filters	string	No	Filters to apply (e.g. eventTypes:14)

Output

Parameter	Type	Description
fixture	object	The requested fixture object
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Fixtures by Date

Retrieve all football fixtures on a specific date (YYYY-MM-DD) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
date	string	Yes	The date to fetch fixtures for, in YYYY-MM-DD format
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores;league)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501,271)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order fixtures by starting_at (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of fixture objects for the requested date
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Fixtures by Date Range

Retrieve football fixtures between two dates (YYYY-MM-DD) from Sportmonks. Max range is 100 days.

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
startDate	string	Yes	Start date in YYYY-MM-DD format
endDate	string	Yes	End date in YYYY-MM-DD format (max 100 days after start)
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501,271)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order fixtures by starting_at (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of fixture objects within the requested date range
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Fixtures by Date Range for Team

Retrieve fixtures for a team within a date range (YYYY-MM-DD) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
startDate	string	Yes	Start date in YYYY-MM-DD format
endDate	string	Yes	End date in YYYY-MM-DD format
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order fixtures by starting_at (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of fixture objects for the team within the date range
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Fixtures by Multiple IDs

Retrieve multiple football fixtures by a comma-separated list of IDs (max 50)

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
ids	string	Yes	Comma-separated fixture IDs (e.g. 18535517,18535518). Maximum of 50 IDs
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501)

Output

Parameter	Type	Description
fixtures	array	Array of fixture objects for the requested IDs
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Grouped Standings by Round

Retrieve the standing table for a round ID grouped by group where applicable from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
roundId	string	Yes	The unique id of the round
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply (e.g. standingGroups:246697)

Output

Parameter	Type	Description
standings	json	Standings for the round: an array of groups (each with id, name and a standings array) when groups exist, otherwise a flat array of standing entries

Get Head to Head

Retrieve the head-to-head fixtures between two teams from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
team1	string	Yes	The id of the first team
team2	string	Yes	The id of the second team
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order fixtures by starting_at (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of head-to-head fixture objects between the two teams
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Inplay Livescores

Retrieve all fixtures that are currently being played (in-play) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores;events)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501)

Output

Parameter	Type	Description
fixtures	array	Array of in-play fixture objects
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Last Updated Coaches

Retrieve all coaches that have received updates in the past two hours

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;nationality)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
coaches	array	Array of recently updated coach objects
↳ id	number	Unique id of the coach
↳ player_id	number	Player related to the coach
↳ sport_id	number	Sport of the coach
↳ country_id	number	Country of the coach
↳ nationality_id	number	Nationality of the coach
↳ city_id	number	Birth city of the coach
↳ common_name	string	Common name of the coach
↳ firstname	string	First name of the coach
↳ lastname	string	Last name of the coach
↳ name	string	Name of the coach
↳ display_name	string	Display name of the coach
↳ image_path	string	URL to the coach headshot
↳ height	number	Height of the coach in cm
↳ weight	number	Weight of the coach in kg
↳ date_of_birth	string	Date of birth of the coach
↳ gender	string	Gender of the coach

Get Latest Updated Fixtures

Retrieve all fixtures that have received updates within the last 10 seconds

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501)

Output

Parameter	Type	Description
fixtures	array	Array of recently updated fixture objects
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Latest Updated Livescores

Retrieve all livescores that have received updates within the last 10 seconds

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501)

Output

Parameter	Type	Description
fixtures	array	Array of recently updated live fixture objects
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Last Updated Players

Retrieve all players that have received updates in the past two hours

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. nationality;position)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
players	array	Array of recently updated player objects
↳ id	number	Unique id of the player
↳ sport_id	number	Sport of the player
↳ country_id	number	Country of birth of the player
↳ nationality_id	number	Nationality of the player
↳ city_id	number	City of birth of the player
↳ position_id	number	Position of the player
↳ detailed_position_id	number	Detailed position of the player
↳ type_id	number	Type of the player
↳ common_name	string	Name the player is known for
↳ firstname	string	First name of the player
↳ lastname	string	Last name of the player
↳ name	string	Name of the player
↳ display_name	string	Display name of the player
↳ image_path	string	URL to the player headshot
↳ height	number	Height of the player in cm
↳ weight	number	Weight of the player in kg
↳ date_of_birth	string	Date of birth of the player
↳ gender	string	Gender of the player

Get Latest Team of the Week

Retrieve the latest Team of the Week (TOTW) for a league ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
leagueId	string	Yes	The unique id of the league
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixture;team;player;round)

Output

Parameter	Type	Description
totw	array	Array of the latest Team of the Week entries for the league
↳ id	number	Unique id of the TOTW entry
↳ player_id	number	Player of the team of the week
↳ fixture_id	number	Fixture the TOTW player played in
↳ round_id	number	Round the fixture is played at
↳ team_id	number	Team the TOTW player played for
↳ rating	string	Rating of the TOTW player
↳ formation_position	number	Player position in the TOTW formation
↳ formation	string	The TOTW's formation

Get Latest Transfers

Retrieve the latest transfers available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fromTeam;toTeam)
filters	string	No	Filters to apply (e.g. transferTypes:219,220)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
transfers	array	Array of the latest transfer objects
↳ id	number	Unique id of the transfer
↳ sport_id	number	Sport of the transfer
↳ player_id	number	Player who transferred
↳ type_id	number	Type of the transfer
↳ from_team_id	number	Team the player transferred from
↳ to_team_id	number	Team the player transferred to
↳ position_id	number	Position id of the transfer
↳ detailed_position_id	number	Detailed position id of the transfer
↳ date	string	Date of the transfer
↳ career_ended	boolean	Whether the transfer ended the career
↳ completed	boolean	Whether the transfer is completed
↳ amount	number	Transfer fee amount

Get League by ID

Retrieve a single football league by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
leagueId	string	Yes	The unique id of the league
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;currentSeason;seasons)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
league	object	The requested league object
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	number	Whether the league is active (1) or inactive (0)
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date the last fixture was played
↳ category	number	Importance category of the league (1-4)

Get Leagues

Retrieve all football leagues available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;currentSeason)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order leagues (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of league objects
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	number	Whether the league is active (1) or inactive (0)
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date the last fixture was played
↳ category	number	Importance category of the league (1-4)

Get Leagues by Country

Retrieve all leagues for a country ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
countryId	string	Yes	The unique id of the country
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;currentSeason)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order leagues (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of league objects for the country
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	number	Whether the league is active (1) or inactive (0)
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date the last fixture was played
↳ category	number	Importance category of the league (1-4)

Get Leagues by Date

Retrieve all leagues with fixtures on a given date (YYYY-MM-DD) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
date	string	Yes	The fixture date in YYYY-MM-DD format
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;currentSeason)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order leagues (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of league objects with fixtures on the requested date
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	number	Whether the league is active (1) or inactive (0)
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date the last fixture was played
↳ category	number	Importance category of the league (1-4)

Get Leagues by Team

Retrieve all current and historical leagues for a team ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;currentSeason)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order leagues (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of current and historical league objects for the team
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	number	Whether the league is active (1) or inactive (0)
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date the last fixture was played
↳ category	number	Importance category of the league (1-4)

Get Live Leagues

Retrieve all leagues that have fixtures currently being played from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;currentSeason)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order leagues (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of currently live league objects
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	number	Whether the league is active (1) or inactive (0)
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date the last fixture was played
↳ category	number	Importance category of the league (1-4)

Get Live Probabilities

Retrieve all live (in-play) prediction probabilities from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. type;fixture)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
predictions	array	Array of live probability prediction objects
↳ id	number	Unique id of the live prediction record
↳ fixture_id	number	Fixture the prediction belongs to
↳ period_id	number	Match period the prediction was recorded in
↳ minute	number	Match minute the prediction was generated
↳ predictions	json	Home win, away win and draw probabilities as percentages
↳ type_id	number	Type of the prediction (237 for fulltime result)

Get Live Probabilities by Fixture

Retrieve all live (in-play) prediction probabilities for a fixture ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
include	string	No	Semicolon-separated relations to enrich the response (e.g. type;fixture)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
predictions	array	Array of live probability prediction objects for the fixture
↳ id	number	Unique id of the live prediction record
↳ fixture_id	number	Fixture the prediction belongs to
↳ period_id	number	Match period the prediction was recorded in
↳ minute	number	Match minute the prediction was generated
↳ predictions	json	Home win, away win and draw probabilities as percentages
↳ type_id	number	Type of the prediction (237 for fulltime result)

Get Live Standings by League

Retrieve the live standing table for a league ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
leagueId	string	Yes	The unique id of the league
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply (e.g. standingGroups:246697)

Output

Parameter	Type	Description
standings	array	Array of live standing entries for the league
↳ id	number	Unique id of the standing
↳ participant_id	number	Team related to the standing
↳ sport_id	number	Sport related to the standing
↳ league_id	number	League related to the standing
↳ season_id	number	Season related to the standing
↳ stage_id	number	Stage related to the standing
↳ group_id	number	Group related to the standing
↳ round_id	number	Round related to the standing
↳ standing_rule_id	number	Standing rule related to the standing
↳ position	number	Position of the team in the standing
↳ result	string	Movement of the team in the standing
↳ points	number	Points the team has gathered

Get Livescores

Retrieve fixtures starting within 15 minutes and currently in progress from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores;events)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501)

Output

Parameter	Type	Description
fixtures	array	Array of live fixture objects
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get All Match Facts

Retrieve all available match facts within your Sportmonks subscription (beta)

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. type;sport;fixture)
filters	string	No	Filters to apply (e.g. matchFactTypes:76088)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
matchFacts	array	Array of match fact objects
↳ id	number	Unique id of the match fact
↳ sport_id	number	Sport of the match fact
↳ fixture_id	number	Fixture related to the match fact
↳ type_id	number	Type of the match fact
↳ participant	string	Team the fact relates to (home or away)
↳ basis	string	Basis of the match fact (e.g. h2h, overall)
↳ data	json	Match fact data payload (counts and percentages)
↳ natural_language	string	Human-readable description of the match fact
↳ category	string	Category of the match fact
↳ scope	string	Scope of the match fact

Get Match Facts by Date Range

Retrieve match facts within a date range (YYYY-MM-DD) from Sportmonks (beta)

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
startDate	string	Yes	Start date in YYYY-MM-DD format
endDate	string	Yes	End date in YYYY-MM-DD format
include	string	No	Semicolon-separated relations to enrich the response (e.g. type;sport;fixture)
filters	string	No	Filters to apply (e.g. matchFactTypes:76088)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
matchFacts	array	Array of match fact objects within the date range
↳ id	number	Unique id of the match fact
↳ sport_id	number	Sport of the match fact
↳ fixture_id	number	Fixture related to the match fact
↳ type_id	number	Type of the match fact
↳ participant	string	Team the fact relates to (home or away)
↳ basis	string	Basis of the match fact (e.g. h2h, overall)
↳ data	json	Match fact data payload (counts and percentages)
↳ natural_language	string	Human-readable description of the match fact
↳ category	string	Category of the match fact
↳ scope	string	Scope of the match fact

Get Match Facts by Fixture

Retrieve match facts for a fixture ID from Sportmonks (beta)

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
include	string	No	Semicolon-separated relations to enrich the response (e.g. type;sport;fixture)
filters	string	No	Filters to apply (e.g. matchFactTypes:76088)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
matchFacts	array	Array of match fact objects for the fixture
↳ id	number	Unique id of the match fact
↳ sport_id	number	Sport of the match fact
↳ fixture_id	number	Fixture related to the match fact
↳ type_id	number	Type of the match fact
↳ participant	string	Team the fact relates to (home or away)
↳ basis	string	Basis of the match fact (e.g. h2h, overall)
↳ data	json	Match fact data payload (counts and percentages)
↳ natural_language	string	Human-readable description of the match fact
↳ category	string	Category of the match fact
↳ scope	string	Scope of the match fact

Get Match Facts by League

Retrieve match facts for a league ID from Sportmonks (beta)

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
leagueId	string	Yes	The unique id of the league
include	string	No	Semicolon-separated relations to enrich the response (e.g. type;sport;fixture)
filters	string	No	Filters to apply (e.g. matchFactTypes:76088)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
matchFacts	array	Array of match fact objects for the league
↳ id	number	Unique id of the match fact
↳ sport_id	number	Sport of the match fact
↳ fixture_id	number	Fixture related to the match fact
↳ type_id	number	Type of the match fact
↳ participant	string	Team the fact relates to (home or away)
↳ basis	string	Basis of the match fact (e.g. h2h, overall)
↳ data	json	Match fact data payload (counts and percentages)
↳ natural_language	string	Human-readable description of the match fact
↳ category	string	Category of the match fact
↳ scope	string	Scope of the match fact

Get Past Fixtures by TV Station

Retrieve all past fixtures that were available for a TV station ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
tvStationId	string	Yes	The unique id of the TV station
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of past fixture objects for the TV station
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Player by ID

Retrieve a single football player by their ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
playerId	string	Yes	The unique id of the player
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;position;teams.team;statistics)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
player	object	The requested player object
↳ id	number	Unique id of the player
↳ sport_id	number	Sport of the player
↳ country_id	number	Country of birth of the player
↳ nationality_id	number	Nationality of the player
↳ city_id	number	City of birth of the player
↳ position_id	number	Position of the player
↳ detailed_position_id	number	Detailed position of the player
↳ type_id	number	Type of the player
↳ common_name	string	Name the player is known for
↳ firstname	string	First name of the player
↳ lastname	string	Last name of the player
↳ name	string	Name of the player
↳ display_name	string	Display name of the player
↳ image_path	string	URL to the player headshot
↳ height	number	Height of the player in cm
↳ weight	number	Weight of the player in kg
↳ date_of_birth	string	Date of birth of the player
↳ gender	string	Gender of the player

Get Players by Country

Retrieve all players for a country ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
countryId	string	Yes	The unique id of the country
include	string	No	Semicolon-separated relations to enrich the response (e.g. nationality;position)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order players by id (asc or desc)

Output

Parameter	Type	Description
players	array	Array of player objects for the country
↳ id	number	Unique id of the player
↳ sport_id	number	Sport of the player
↳ country_id	number	Country of birth of the player
↳ nationality_id	number	Nationality of the player
↳ city_id	number	City of birth of the player
↳ position_id	number	Position of the player
↳ detailed_position_id	number	Detailed position of the player
↳ type_id	number	Type of the player
↳ common_name	string	Name the player is known for
↳ firstname	string	First name of the player
↳ lastname	string	Last name of the player
↳ name	string	Name of the player
↳ display_name	string	Display name of the player
↳ image_path	string	URL to the player headshot
↳ height	number	Height of the player in cm
↳ weight	number	Weight of the player in kg
↳ date_of_birth	string	Date of birth of the player
↳ gender	string	Gender of the player

Get Post-Match News

Retrieve all post-match news articles available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixture;league)
filters	string	No	Filters to apply (e.g. newsitemLeagues:8)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order news by id (asc or desc)

Output

Parameter	Type	Description
news	array	Array of post-match news articles
↳ id	number	Unique id of the news article
↳ fixture_id	number	Fixture related to the news article
↳ league_id	number	League related to the news article
↳ title	string	Title of the news article
↳ type	string	Type of the news (prematch or postmatch)

Get Post-Match News by Season

Retrieve all post-match news articles for a season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixture;league)
filters	string	No	Filters to apply (e.g. newsitemLeagues:8)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order news (asc or desc)

Output

Parameter	Type	Description
news	array	Array of post-match news articles for the season
↳ id	number	Unique id of the news article
↳ fixture_id	number	Fixture related to the news article
↳ league_id	number	League related to the news article
↳ title	string	Title of the news article
↳ type	string	Type of the news (prematch or postmatch)

Get Predictability by League

Retrieve the predictions model performance for a league ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
leagueId	string	Yes	The unique id of the league
include	string	No	Semicolon-separated relations to enrich the response (e.g. type;league)
filters	string	No	Filters to apply (e.g. predictabilityTypes:245)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
predictability	array	Array of predictability records for the league
↳ id	number	Unique id of the predictability record
↳ league_id	number	League related to the predictability
↳ type_id	number	Type of the predictability
↳ data	json	Predictability values per market

Get Pre-Match News

Retrieve all pre-match news articles available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixture;league)
filters	string	No	Filters to apply (e.g. newsitemLeagues:8)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order news by id (asc or desc)

Output

Parameter	Type	Description
news	array	Array of pre-match news articles
↳ id	number	Unique id of the news article
↳ fixture_id	number	Fixture related to the news article
↳ league_id	number	League related to the news article
↳ title	string	Title of the news article
↳ type	string	Type of the news (prematch or postmatch)

Get Pre-Match News by Season

Retrieve all pre-match news articles for a season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixture;league)
filters	string	No	Filters to apply (e.g. newsitemLeagues:8)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order news (asc or desc)

Output

Parameter	Type	Description
news	array	Array of pre-match news articles for the season
↳ id	number	Unique id of the news article
↳ fixture_id	number	Fixture related to the news article
↳ league_id	number	League related to the news article
↳ title	string	Title of the news article
↳ type	string	Type of the news (prematch or postmatch)

Get Pre-Match News for Upcoming Fixtures

Retrieve all pre-match news articles for upcoming fixtures from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixture;league)
filters	string	No	Filters to apply (e.g. newsitemLeagues:8)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order news (asc or desc)

Output

Parameter	Type	Description
news	array	Array of pre-match news articles for upcoming fixtures
↳ id	number	Unique id of the news article
↳ fixture_id	number	Fixture related to the news article
↳ league_id	number	League related to the news article
↳ title	string	Title of the news article
↳ type	string	Type of the news (prematch or postmatch)

Get Probabilities

Retrieve all prediction probabilities available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. type;fixture)
filters	string	No	Filters to apply (e.g. predictionTypes:236)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
predictions	array	Array of prediction probability objects
↳ id	number	Unique id of the prediction
↳ fixture_id	number	Fixture related to the prediction
↳ predictions	json	Prediction payload (varies by type: score map, value bet object, etc.)
↳ type_id	number	Type of the prediction

Get Predictions by Fixture

Retrieve prediction probabilities for a fixture by fixture ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
include	string	No	Semicolon-separated relations to enrich the response (e.g. type;fixture)
filters	string	No	Filters to apply (e.g. predictionTypes:236)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
predictions	array	Array of prediction probability entries for the fixture
↳ id	number	Unique id of the prediction
↳ fixture_id	number	Fixture related to the prediction
↳ predictions	json	Prediction payload (varies by type: score map, value bet object, etc.)
↳ type_id	number	Type of the prediction

Get Referee by ID

Retrieve a single football referee by their ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
refereeId	string	Yes	The unique id of the referee
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;statistics)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
referee	object	The requested referee object
↳ id	number	Unique id of the referee
↳ sport_id	number	Sport of the referee
↳ country_id	number	Country of the referee
↳ nationality_id	number	Nationality of the referee
↳ city_id	number	Birth city of the referee
↳ common_name	string	Common name of the referee
↳ firstname	string	First name of the referee
↳ lastname	string	Last name of the referee
↳ name	string	Name of the referee
↳ display_name	string	Display name of the referee
↳ image_path	string	URL to the referee headshot
↳ height	number	Height of the referee in cm
↳ weight	number	Weight of the referee in kg
↳ date_of_birth	string	Date of birth of the referee
↳ gender	string	Gender of the referee

Get Referees

Retrieve all football referees available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;statistics)
filters	string	No	Filters to apply (e.g. refereeCountries:44)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
referees	array	Array of referee objects
↳ id	number	Unique id of the referee
↳ sport_id	number	Sport of the referee
↳ country_id	number	Country of the referee
↳ nationality_id	number	Nationality of the referee
↳ city_id	number	Birth city of the referee
↳ common_name	string	Common name of the referee
↳ firstname	string	First name of the referee
↳ lastname	string	Last name of the referee
↳ name	string	Name of the referee
↳ display_name	string	Display name of the referee
↳ image_path	string	URL to the referee headshot
↳ height	number	Height of the referee in cm
↳ weight	number	Weight of the referee in kg
↳ date_of_birth	string	Date of birth of the referee
↳ gender	string	Gender of the referee

Get Referees by Country

Retrieve all referees for a country ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
countryId	string	Yes	The unique id of the country
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;nationality)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
referees	array	Array of referee objects for the country
↳ id	number	Unique id of the referee
↳ sport_id	number	Sport of the referee
↳ country_id	number	Country of the referee
↳ nationality_id	number	Nationality of the referee
↳ city_id	number	Birth city of the referee
↳ common_name	string	Common name of the referee
↳ firstname	string	First name of the referee
↳ lastname	string	Last name of the referee
↳ name	string	Name of the referee
↳ display_name	string	Display name of the referee
↳ image_path	string	URL to the referee headshot
↳ height	number	Height of the referee in cm
↳ weight	number	Weight of the referee in kg
↳ date_of_birth	string	Date of birth of the referee
↳ gender	string	Gender of the referee

Get Referees by Season

Retrieve all referees for a season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;nationality)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
referees	array	Array of referee objects for the season
↳ id	number	Unique id of the referee
↳ sport_id	number	Sport of the referee
↳ country_id	number	Country of the referee
↳ nationality_id	number	Nationality of the referee
↳ city_id	number	Birth city of the referee
↳ common_name	string	Common name of the referee
↳ firstname	string	First name of the referee
↳ lastname	string	Last name of the referee
↳ name	string	Name of the referee
↳ display_name	string	Display name of the referee
↳ image_path	string	URL to the referee headshot
↳ height	number	Height of the referee in cm
↳ weight	number	Weight of the referee in kg
↳ date_of_birth	string	Date of birth of the referee
↳ gender	string	Gender of the referee

Get Rivals by Team

Retrieve rival teams for a team by team ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. team;rival)

Output

Parameter	Type	Description
rivals	array	Array of rival relationships for the team
↳ sport_id	number	Sport of the rival
↳ team_id	number	Team the rivalry belongs to
↳ rival_id	number	Rival team id

Get Round by ID

Retrieve a single football round by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
roundId	string	Yes	The unique id of the round
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;season;stage;fixtures)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
round	object	The requested round object
↳ id	number	Unique id of the round
↳ sport_id	number	Sport of the round
↳ league_id	number	League of the round
↳ season_id	number	Season of the round
↳ stage_id	number	Stage of the round
↳ name	string	Name of the round
↳ finished	boolean	Whether the round is finished
↳ is_current	boolean	Whether the round is the current round
↳ starting_at	string	Start date of the round
↳ ending_at	string	End date of the round
↳ games_in_current_week	boolean	Whether the round has fixtures this week

Get Round Statistics

Retrieve all available statistics for a round ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
roundId	string	Yes	The unique id of the round
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant)
filters	string	No	Filters to apply (e.g. seasonstatisticTypes:52,88)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
statistics	array	Array of statistic entries for the round
↳ id	number	Unique id of the statistic record
↳ model_id	number	Id of the entity the statistic belongs to
↳ type_id	number	Type of the statistic
↳ relation_id	number	Related entity id (e.g. participant) when applicable
↳ value	json	Statistic value payload (varies by type)

Get Rounds

Retrieve all football rounds available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;season;stage)
filters	string	No	Filters to apply (e.g. roundSeasons:19735)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
rounds	array	Array of round objects
↳ id	number	Unique id of the round
↳ sport_id	number	Sport of the round
↳ league_id	number	League of the round
↳ season_id	number	Season of the round
↳ stage_id	number	Stage of the round
↳ name	string	Name of the round
↳ finished	boolean	Whether the round is finished
↳ is_current	boolean	Whether the round is the current round
↳ starting_at	string	Start date of the round
↳ ending_at	string	End date of the round
↳ games_in_current_week	boolean	Whether the round has fixtures this week

Get Rounds by Season

Retrieve all rounds for a season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;stage)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
rounds	array	Array of round objects for the season
↳ id	number	Unique id of the round
↳ sport_id	number	Sport of the round
↳ league_id	number	League of the round
↳ season_id	number	Season of the round
↳ stage_id	number	Stage of the round
↳ name	string	Name of the round
↳ finished	boolean	Whether the round is finished
↳ is_current	boolean	Whether the round is the current round
↳ starting_at	string	Start date of the round
↳ ending_at	string	End date of the round
↳ games_in_current_week	boolean	Whether the round has fixtures this week

Get Schedules by Season

Retrieve the full schedule (stages, rounds and fixtures) for a season by season ID

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season

Output

Parameter	Type	Description
schedules	json	Array of stages, each with nested rounds and their fixtures (participants, scores)

Get Schedules by Season and Team

Retrieve the full season schedule for a specific team by season ID and team ID

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
teamId	string	Yes	The unique id of the team

Output

Parameter	Type	Description
schedules	json	Array of stages, each with nested rounds and their fixtures for the team in the season

Get Schedules by Team

Retrieve the full schedule (stages, rounds and fixtures) for a team by team ID

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team

Output

Parameter	Type	Description
schedules	json	Array of stages, each with nested rounds and their fixtures (participants, scores)

Get Season by ID

Retrieve a single football season by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;stages;fixtures)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
season	object	The requested season object
↳ id	number	Unique id of the season
↳ sport_id	number	Sport of the season
↳ league_id	number	League of the season
↳ tie_breaker_rule_id	number	Tie-breaker rule of the season
↳ name	string	Name of the season (e.g. 2023/2024)
↳ finished	boolean	Whether the season is finished
↳ pending	boolean	Whether the season is pending
↳ is_current	boolean	Whether the season is the current season
↳ standing_method	string	Standing calculation method
↳ starting_at	string	Start date of the season
↳ ending_at	string	End date of the season
↳ standings_recalculated_at	string	Last standings recalculation time
↳ games_in_current_week	boolean	Whether the season has fixtures this week

Get Seasons

Retrieve all football seasons available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;stages)
filters	string	No	Filters to apply (e.g. seasonLeagues:501)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
seasons	array	Array of season objects
↳ id	number	Unique id of the season
↳ sport_id	number	Sport of the season
↳ league_id	number	League of the season
↳ tie_breaker_rule_id	number	Tie-breaker rule of the season
↳ name	string	Name of the season (e.g. 2023/2024)
↳ finished	boolean	Whether the season is finished
↳ pending	boolean	Whether the season is pending
↳ is_current	boolean	Whether the season is the current season
↳ standing_method	string	Standing calculation method
↳ starting_at	string	Start date of the season
↳ ending_at	string	End date of the season
↳ standings_recalculated_at	string	Last standings recalculation time
↳ games_in_current_week	boolean	Whether the season has fixtures this week

Get Seasons by Team

Retrieve all seasons for a team ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;stages)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
seasons	array	Array of season objects for the team
↳ id	number	Unique id of the season
↳ sport_id	number	Sport of the season
↳ league_id	number	League of the season
↳ tie_breaker_rule_id	number	Tie-breaker rule of the season
↳ name	string	Name of the season (e.g. 2023/2024)
↳ finished	boolean	Whether the season is finished
↳ pending	boolean	Whether the season is pending
↳ is_current	boolean	Whether the season is the current season
↳ standing_method	string	Standing calculation method
↳ starting_at	string	Start date of the season
↳ ending_at	string	End date of the season
↳ standings_recalculated_at	string	Last standings recalculation time
↳ games_in_current_week	boolean	Whether the season has fixtures this week

Get Stage by ID

Retrieve a single football stage by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
stageId	string	Yes	The unique id of the stage
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;season;rounds)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
stage	object	The requested stage object
↳ id	number	Unique id of the stage
↳ sport_id	number	Sport of the stage
↳ league_id	number	League of the stage
↳ season_id	number	Season of the stage
↳ type_id	number	Type of the stage
↳ name	string	Name of the stage
↳ sort_order	number	Sort order of the stage
↳ finished	boolean	Whether the stage is finished
↳ is_current	boolean	Whether the stage is the current stage
↳ starting_at	string	Start date of the stage
↳ ending_at	string	End date of the stage
↳ games_in_current_week	boolean	Whether the stage has fixtures this week

Get Stage Statistics

Retrieve all available statistics for a stage ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
stageId	string	Yes	The unique id of the stage
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant)
filters	string	No	Filters to apply (e.g. seasonstatisticTypes:52,88)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
statistics	array	Array of statistic entries for the stage
↳ id	number	Unique id of the statistic record
↳ model_id	number	Id of the entity the statistic belongs to
↳ type_id	number	Type of the statistic
↳ relation_id	number	Related entity id (e.g. participant) when applicable
↳ value	json	Statistic value payload (varies by type)

Get Stages

Retrieve all football stages available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;season;rounds)
filters	string	No	Filters to apply (e.g. stageSeasons:19735)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
stages	array	Array of stage objects
↳ id	number	Unique id of the stage
↳ sport_id	number	Sport of the stage
↳ league_id	number	League of the stage
↳ season_id	number	Season of the stage
↳ type_id	number	Type of the stage
↳ name	string	Name of the stage
↳ sort_order	number	Sort order of the stage
↳ finished	boolean	Whether the stage is finished
↳ is_current	boolean	Whether the stage is the current stage
↳ starting_at	string	Start date of the stage
↳ ending_at	string	End date of the stage
↳ games_in_current_week	boolean	Whether the stage has fixtures this week

Get Stages by Season

Retrieve all stages for a season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;rounds)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
stages	array	Array of stage objects for the season
↳ id	number	Unique id of the stage
↳ sport_id	number	Sport of the stage
↳ league_id	number	League of the stage
↳ season_id	number	Season of the stage
↳ type_id	number	Type of the stage
↳ name	string	Name of the stage
↳ sort_order	number	Sort order of the stage
↳ finished	boolean	Whether the stage is finished
↳ is_current	boolean	Whether the stage is the current stage
↳ starting_at	string	Start date of the stage
↳ ending_at	string	End date of the stage
↳ games_in_current_week	boolean	Whether the stage has fixtures this week

Get Standing Corrections by Season

Retrieve point corrections (awarded or deducted) for a season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;stage)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
corrections	array	Array of standing correction entries for the season
↳ id	number	Unique id of the standing correction
↳ season_id	number	Season related to the correction
↳ stage_id	number	Stage related to the correction
↳ group_id	number	Group related to the correction
↳ type_id	number	Type of the correction
↳ value	number	Amount of points awarded or deducted
↳ calc_type	string	Calculation type applied (e.g. + or -)
↳ participant_type	string	Type of the participant (e.g. team)
↳ participant_id	number	Participant the correction applies to
↳ active	boolean	Whether the correction is active

Get All Standings

Retrieve all standings available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;league;season)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
standings	array	Array of standing entries
↳ id	number	Unique id of the standing
↳ participant_id	number	Team related to the standing
↳ sport_id	number	Sport related to the standing
↳ league_id	number	League related to the standing
↳ season_id	number	Season related to the standing
↳ stage_id	number	Stage related to the standing
↳ group_id	number	Group related to the standing
↳ round_id	number	Round related to the standing
↳ standing_rule_id	number	Standing rule related to the standing
↳ position	number	Position of the team in the standing
↳ result	string	Movement of the team in the standing
↳ points	number	Points the team has gathered

Get Standings by Round

Retrieve the full standing table for a round ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
roundId	string	Yes	The unique id of the round
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply (e.g. standingGroups:246697)

Output

Parameter	Type	Description
standings	array	Array of standing entries for the round
↳ id	number	Unique id of the standing
↳ participant_id	number	Team related to the standing
↳ sport_id	number	Sport related to the standing
↳ league_id	number	League related to the standing
↳ season_id	number	Season related to the standing
↳ stage_id	number	Stage related to the standing
↳ group_id	number	Group related to the standing
↳ round_id	number	Round related to the standing
↳ standing_rule_id	number	Standing rule related to the standing
↳ position	number	Position of the team in the standing
↳ result	string	Movement of the team in the standing
↳ points	number	Points the team has gathered

Get Standings by Season

Retrieve the full league standings table for a season by season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details;form)
filters	string	No	Filters to apply (e.g. standingStages:77453568)

Output

Parameter	Type	Description
standings	array	Array of standing entries for the season
↳ id	number	Unique id of the standing
↳ participant_id	number	Team related to the standing
↳ sport_id	number	Sport related to the standing
↳ league_id	number	League related to the standing
↳ season_id	number	Season related to the standing
↳ stage_id	number	Stage related to the standing
↳ group_id	number	Group related to the standing
↳ round_id	number	Round related to the standing
↳ standing_rule_id	number	Standing rule related to the standing
↳ position	number	Position of the team in the standing
↳ result	string	Movement of the team in the standing
↳ points	number	Points the team has gathered

Get State by ID

Retrieve a single fixture state by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
stateId	string	Yes	The unique id of the state

Output

Parameter	Type	Description
state	object	The requested fixture state object
↳ id	number	Unique id of the state
↳ state	string	State code (e.g. NS, INPLAY_1ST_HALF)
↳ name	string	Full name of the state (e.g. Not Started)
↳ short_name	string	Short name of the state (e.g. NS)
↳ developer_name	string	Developer name of the state

Get States

Retrieve all fixture states (e.g. Not Started, 1st Half, Full Time) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
states	array	Array of fixture state objects
↳ id	number	Unique id of the state
↳ state	string	State code (e.g. NS, INPLAY_1ST_HALF)
↳ name	string	Full name of the state (e.g. Not Started)
↳ short_name	string	Short name of the state (e.g. NS)
↳ developer_name	string	Developer name of the state

Get Team by ID

Retrieve a single football team by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;venue;coaches;players.player)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
team	object	The requested team object
↳ id	number	Unique id of the team
↳ sport_id	number	Sport of the team
↳ country_id	number	Country of the team
↳ venue_id	number	Home venue of the team
↳ gender	string	Gender of the team
↳ name	string	Name of the team
↳ short_code	string	Short code of the team
↳ image_path	string	URL to the team logo
↳ founded	number	Founding year of the team
↳ type	string	Type of the team
↳ placeholder	boolean	Whether the team is a placeholder
↳ last_played_at	string	Date and time of the last played match

Get All Team Rankings

Retrieve all team rankings available within your Sportmonks subscription (beta)

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. team)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
teamRankings	array	Array of team ranking objects
↳ id	number	Unique id of the team ranking
↳ team_id	number	Team related to the ranking
↳ date	string	Date of the ranking
↳ current_rank	number	Placement of the team on that date
↳ scaled_score	number	Scaled score of the team (0-100)

Get Team Rankings by Date

Retrieve team rankings for a given date (YYYY-MM-DD) from Sportmonks (beta)

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
date	string	Yes	The ranking date in YYYY-MM-DD format
include	string	No	Semicolon-separated relations to enrich the response (e.g. team)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
teamRankings	array	Array of team ranking objects for the date
↳ id	number	Unique id of the team ranking
↳ team_id	number	Team related to the ranking
↳ date	string	Date of the ranking
↳ current_rank	number	Placement of the team on that date
↳ scaled_score	number	Scaled score of the team (0-100)

Get Team Rankings by Team

Retrieve team rankings for a team ID from Sportmonks (beta)

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. team)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
teamRankings	array	Array of team ranking objects for the team
↳ id	number	Unique id of the team ranking
↳ team_id	number	Team related to the ranking
↳ date	string	Date of the ranking
↳ current_rank	number	Placement of the team on that date
↳ scaled_score	number	Scaled score of the team (0-100)

Get Team Squad

Retrieve the current domestic squad for a team by team ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;position)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
squad	array	Array of squad entries for the team
↳ id	number	Unique id of the squad record
↳ transfer_id	number	Transfer id of the squad record
↳ player_id	number	Player in the squad
↳ team_id	number	Team of the squad
↳ position_id	number	Position of the player in the squad
↳ detailed_position_id	number	Detailed position of the player in the squad
↳ jersey_number	number	Jersey number of the player
↳ start	string	Start contract date of the player
↳ end	string	End contract date of the player

Get Team Squad by Season

Retrieve the (historical) squad for a team in a specific season from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;position)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
squad	array	Array of squad entries for the team in the season
↳ id	number	Unique id of the squad record
↳ transfer_id	number	Transfer id of the squad record
↳ player_id	number	Player in the squad
↳ team_id	number	Team of the squad
↳ position_id	number	Position of the player in the squad
↳ detailed_position_id	number	Detailed position of the player in the squad
↳ jersey_number	number	Jersey number of the player
↳ start	string	Start contract date of the player
↳ end	string	End contract date of the player

Get Teams by Country

Retrieve all teams for a country ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
countryId	string	Yes	The unique id of the country
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;venue)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order teams by id (asc or desc)

Output

Parameter	Type	Description
teams	array	Array of team objects for the country
↳ id	number	Unique id of the team
↳ sport_id	number	Sport of the team
↳ country_id	number	Country of the team
↳ venue_id	number	Home venue of the team
↳ gender	string	Gender of the team
↳ name	string	Name of the team
↳ short_code	string	Short code of the team
↳ image_path	string	URL to the team logo
↳ founded	number	Founding year of the team
↳ type	string	Type of the team
↳ placeholder	boolean	Whether the team is a placeholder
↳ last_played_at	string	Date and time of the last played match

Get Teams by Season

Retrieve all teams for a season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;venue)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order teams by id (asc or desc)

Output

Parameter	Type	Description
teams	array	Array of team objects for the season
↳ id	number	Unique id of the team
↳ sport_id	number	Sport of the team
↳ country_id	number	Country of the team
↳ venue_id	number	Home venue of the team
↳ gender	string	Gender of the team
↳ name	string	Name of the team
↳ short_code	string	Short code of the team
↳ image_path	string	URL to the team logo
↳ founded	number	Founding year of the team
↳ type	string	Type of the team
↳ placeholder	boolean	Whether the team is a placeholder
↳ last_played_at	string	Date and time of the last played match

Get Topscorers by Season

Retrieve the topscorers (goals, assists, cards) for a season by season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;participant;type)
filters	string	No	Filters to apply (e.g. seasontopscorerTypes:208)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order topscorers by position (asc or desc)

Output

Parameter	Type	Description
topscorers	array	Array of topscorer entries for the season
↳ id	number	Unique id of the topscorer record
↳ season_id	number	Season related to the topscorer (absent on stage topscorers)
↳ league_id	number	League related to the topscorer
↳ stage_id	number	Stage related to the topscorer
↳ player_id	number	Player related to the topscorer
↳ participant_id	number	Team related to the topscorer
↳ type_id	number	Type of the topscorer (goals, assists, cards)
↳ position	number	Position of the topscorer
↳ total	number	Number of goals, assists or cards

Get Topscorers by Stage

Retrieve topscorers for a stage by stage ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
stageId	string	Yes	The unique id of the stage
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;participant;type)
filters	string	No	Filters to apply (e.g. stageTopscorerTypes:208)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
topscorers	array	Array of topscorer entries for the stage
↳ id	number	Unique id of the topscorer record
↳ season_id	number	Season related to the topscorer (absent on stage topscorers)
↳ league_id	number	League related to the topscorer
↳ stage_id	number	Stage related to the topscorer
↳ player_id	number	Player related to the topscorer
↳ participant_id	number	Team related to the topscorer
↳ type_id	number	Type of the topscorer (goals, assists, cards)
↳ position	number	Position of the topscorer
↳ total	number	Number of goals, assists or cards

Get All Team of the Week

Retrieve all available Team of the Week (TOTW) entries from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixture;team;player;round)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
totw	array	Array of Team of the Week entries
↳ id	number	Unique id of the TOTW entry
↳ player_id	number	Player of the team of the week
↳ fixture_id	number	Fixture the TOTW player played in
↳ round_id	number	Round the fixture is played at
↳ team_id	number	Team the TOTW player played for
↳ rating	string	Rating of the TOTW player
↳ formation_position	number	Player position in the TOTW formation
↳ formation	string	The TOTW's formation

Get Team of the Week by Round

Retrieve the Team of the Week (TOTW) for a round ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
roundId	string	Yes	The unique id of the round
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixture;team;player;round)

Output

Parameter	Type	Description
totw	array	Array of Team of the Week entries for the round
↳ id	number	Unique id of the TOTW entry
↳ player_id	number	Player of the team of the week
↳ fixture_id	number	Fixture the TOTW player played in
↳ round_id	number	Round the fixture is played at
↳ team_id	number	Team the TOTW player played for
↳ rating	string	Rating of the TOTW player
↳ formation_position	number	Player position in the TOTW formation
↳ formation	string	The TOTW's formation

Get Transfer by ID

Retrieve a single transfer by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
transferId	string	Yes	The unique id of the transfer
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fromTeam;toTeam)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
transfer	object	The requested transfer object
↳ id	number	Unique id of the transfer
↳ sport_id	number	Sport of the transfer
↳ player_id	number	Player who transferred
↳ type_id	number	Type of the transfer
↳ from_team_id	number	Team the player transferred from
↳ to_team_id	number	Team the player transferred to
↳ position_id	number	Position id of the transfer
↳ detailed_position_id	number	Detailed position id of the transfer
↳ date	string	Date of the transfer
↳ career_ended	boolean	Whether the transfer ended the career
↳ completed	boolean	Whether the transfer is completed
↳ amount	number	Transfer fee amount

Get Transfer Rumour by ID

Retrieve a single transfer rumour by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
rumourId	string	Yes	The unique id of the transfer rumour
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fromTeam;toTeam)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
transferRumour	object	The requested transfer rumour object
↳ id	number	Unique id of the transfer rumour
↳ sport_id	number	Sport of the transfer rumour
↳ player_id	number	Player the rumour relates to
↳ position_id	number	Position id of the player
↳ from_team_id	number	Team the player would transfer from
↳ to_team_id	number	Team the player would transfer to
↳ transfer_fee_id	number	Transfer fee id of the rumour
↳ probability	string	Probability of the rumour (e.g. LOW)
↳ source_name	string	Name of the source of the rumour
↳ source_url	string	URL of the source of the rumour
↳ amount	number	Estimated transfer fee amount
↳ currency	string	Currency of the amount
↳ date	string	Date of the rumour
↳ type_id	number	Type of the transfer rumour

Get Transfer Rumours Between Dates

Retrieve transfer rumours within a date range (YYYY-MM-DD) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
startDate	string	Yes	Start date in YYYY-MM-DD format
endDate	string	Yes	End date in YYYY-MM-DD format
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fromTeam;toTeam)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
transferRumours	array	Array of transfer rumour objects within the date range
↳ id	number	Unique id of the transfer rumour
↳ sport_id	number	Sport of the transfer rumour
↳ player_id	number	Player the rumour relates to
↳ position_id	number	Position id of the player
↳ from_team_id	number	Team the player would transfer from
↳ to_team_id	number	Team the player would transfer to
↳ transfer_fee_id	number	Transfer fee id of the rumour
↳ probability	string	Probability of the rumour (e.g. LOW)
↳ source_name	string	Name of the source of the rumour
↳ source_url	string	URL of the source of the rumour
↳ amount	number	Estimated transfer fee amount
↳ currency	string	Currency of the amount
↳ date	string	Date of the rumour
↳ type_id	number	Type of the transfer rumour

Get Transfer Rumours by Player

Retrieve transfer rumours for a player ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
playerId	string	Yes	The unique id of the player
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fromTeam;toTeam)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
transferRumours	array	Array of transfer rumour objects for the player
↳ id	number	Unique id of the transfer rumour
↳ sport_id	number	Sport of the transfer rumour
↳ player_id	number	Player the rumour relates to
↳ position_id	number	Position id of the player
↳ from_team_id	number	Team the player would transfer from
↳ to_team_id	number	Team the player would transfer to
↳ transfer_fee_id	number	Transfer fee id of the rumour
↳ probability	string	Probability of the rumour (e.g. LOW)
↳ source_name	string	Name of the source of the rumour
↳ source_url	string	URL of the source of the rumour
↳ amount	number	Estimated transfer fee amount
↳ currency	string	Currency of the amount
↳ date	string	Date of the rumour
↳ type_id	number	Type of the transfer rumour

Get Transfer Rumours by Team

Retrieve transfer rumours for a team ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fromTeam;toTeam)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
transferRumours	array	Array of transfer rumour objects for the team
↳ id	number	Unique id of the transfer rumour
↳ sport_id	number	Sport of the transfer rumour
↳ player_id	number	Player the rumour relates to
↳ position_id	number	Position id of the player
↳ from_team_id	number	Team the player would transfer from
↳ to_team_id	number	Team the player would transfer to
↳ transfer_fee_id	number	Transfer fee id of the rumour
↳ probability	string	Probability of the rumour (e.g. LOW)
↳ source_name	string	Name of the source of the rumour
↳ source_url	string	URL of the source of the rumour
↳ amount	number	Estimated transfer fee amount
↳ currency	string	Currency of the amount
↳ date	string	Date of the rumour
↳ type_id	number	Type of the transfer rumour

Get Transfers Between Dates

Retrieve transfers within a date range (YYYY-MM-DD) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
startDate	string	Yes	Start date in YYYY-MM-DD format
endDate	string	Yes	End date in YYYY-MM-DD format
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fromTeam;toTeam)
filters	string	No	Filters to apply (e.g. transferTypes:219,220)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
transfers	array	Array of transfer objects within the date range
↳ id	number	Unique id of the transfer
↳ sport_id	number	Sport of the transfer
↳ player_id	number	Player who transferred
↳ type_id	number	Type of the transfer
↳ from_team_id	number	Team the player transferred from
↳ to_team_id	number	Team the player transferred to
↳ position_id	number	Position id of the transfer
↳ detailed_position_id	number	Detailed position id of the transfer
↳ date	string	Date of the transfer
↳ career_ended	boolean	Whether the transfer ended the career
↳ completed	boolean	Whether the transfer is completed
↳ amount	number	Transfer fee amount

Get Transfers by Player

Retrieve transfers for a player by player ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
playerId	string	Yes	The unique id of the player
include	string	No	Semicolon-separated relations to enrich the response (e.g. fromTeam;toTeam;type)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
transfers	array	Array of transfer objects for the player
↳ id	number	Unique id of the transfer
↳ sport_id	number	Sport of the transfer
↳ player_id	number	Player who transferred
↳ type_id	number	Type of the transfer
↳ from_team_id	number	Team the player transferred from
↳ to_team_id	number	Team the player transferred to
↳ position_id	number	Position id of the transfer
↳ detailed_position_id	number	Detailed position id of the transfer
↳ date	string	Date of the transfer
↳ career_ended	boolean	Whether the transfer ended the career
↳ completed	boolean	Whether the transfer is completed
↳ amount	number	Transfer fee amount

Get Transfers by Team

Retrieve transfers for a team by team ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team
include	string	No	Semicolon-separated relations to enrich the response (e.g. player;fromTeam;toTeam)
filters	string	No	Filters to apply (e.g. transferTypes:219,220)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
transfers	array	Array of transfer objects for the team
↳ id	number	Unique id of the transfer
↳ sport_id	number	Sport of the transfer
↳ player_id	number	Player who transferred
↳ type_id	number	Type of the transfer
↳ from_team_id	number	Team the player transferred from
↳ to_team_id	number	Team the player transferred to
↳ position_id	number	Position id of the transfer
↳ detailed_position_id	number	Detailed position id of the transfer
↳ date	string	Date of the transfer
↳ career_ended	boolean	Whether the transfer ended the career
↳ completed	boolean	Whether the transfer is completed
↳ amount	number	Transfer fee amount

Get TV Station by ID

Retrieve a single TV station by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
tvStationId	string	Yes	The unique id of the TV station
include	string	No	Semicolon-separated relations to enrich the response
filters	string	No	Filters to apply

Output

Parameter	Type	Description
tvStation	object	The requested TV station object
↳ id	number	Unique id of the TV station
↳ name	string	Name of the TV station
↳ url	string	URL of the TV station
↳ image_path	string	Image path of the TV station
↳ type	string	Type of the TV station (tv, channel)
↳ related_id	number	Related id of the TV station

Get TV Stations

Retrieve all TV stations available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
tvStations	array	Array of TV station objects
↳ id	number	Unique id of the TV station
↳ name	string	Name of the TV station
↳ url	string	URL of the TV station
↳ image_path	string	Image path of the TV station
↳ type	string	Type of the TV station (tv, channel)
↳ related_id	number	Related id of the TV station

Get TV Stations by Fixture

Retrieve broadcasting TV stations for a fixture by fixture ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
include	string	No	Semicolon-separated relations to enrich the response (e.g. fixtures;countries)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
tvStations	array	Array of TV station objects broadcasting the fixture
↳ id	number	Unique id of the TV station
↳ name	string	Name of the TV station
↳ url	string	URL of the TV station
↳ image_path	string	Image path of the TV station
↳ type	string	Type of the TV station (tv, channel)
↳ related_id	number	Related id of the TV station

Get Upcoming Fixtures by Market

Retrieve all upcoming fixtures for a market ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
marketId	string	Yes	The unique id of the market
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;odds)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of upcoming fixture objects for the market
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Upcoming Fixtures by TV Station

Retrieve all upcoming fixtures available for a TV station ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
tvStationId	string	Yes	The unique id of the TV station
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of upcoming fixture objects for the TV station
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Value Bets

Retrieve all value bets available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. type;fixture)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
valueBets	array	Array of value bet prediction objects
↳ id	number	Unique id of the prediction
↳ fixture_id	number	Fixture related to the prediction
↳ predictions	json	Prediction payload (varies by type: score map, value bet object, etc.)
↳ type_id	number	Type of the prediction

Get Value Bets by Fixture

Retrieve value bet predictions for a fixture by fixture ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
include	string	No	Semicolon-separated relations to enrich the response (e.g. type;fixture)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
valueBets	array	Array of value bet prediction entries for the fixture
↳ id	number	Unique id of the prediction
↳ fixture_id	number	Fixture related to the prediction
↳ predictions	json	Prediction payload (varies by type: score map, value bet object, etc.)
↳ type_id	number	Type of the prediction

Get Venue by ID

Retrieve a single football venue by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
venueId	string	Yes	The unique id of the venue
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;city;fixtures)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
venue	object	The requested venue object
↳ id	number	Unique id of the venue
↳ country_id	number	Country of the venue
↳ city_id	number	City of the venue
↳ name	string	Name of the venue
↳ address	string	Address of the venue
↳ zipcode	string	Zipcode of the venue
↳ latitude	string	Latitude of the venue
↳ longitude	string	Longitude of the venue
↳ capacity	number	Seating capacity of the venue
↳ image_path	string	Image path of the venue
↳ city_name	string	Name of the city the venue is in
↳ surface	string	Surface type of the venue
↳ national_team	boolean	Whether the venue is used by the national team

Get Venues

Retrieve all football venues available within your Sportmonks subscription

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;city)
filters	string	No	Filters to apply (e.g. venueCountries:98)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
venues	array	Array of venue objects
↳ id	number	Unique id of the venue
↳ country_id	number	Country of the venue
↳ city_id	number	City of the venue
↳ name	string	Name of the venue
↳ address	string	Address of the venue
↳ zipcode	string	Zipcode of the venue
↳ latitude	string	Latitude of the venue
↳ longitude	string	Longitude of the venue
↳ capacity	number	Seating capacity of the venue
↳ image_path	string	Image path of the venue
↳ city_name	string	Name of the city the venue is in
↳ surface	string	Surface type of the venue
↳ national_team	boolean	Whether the venue is used by the national team

Get Venues by Season

Retrieve all venues for a season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;city)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
venues	array	Array of venue objects for the season
↳ id	number	Unique id of the venue
↳ country_id	number	Country of the venue
↳ city_id	number	City of the venue
↳ name	string	Name of the venue
↳ address	string	Address of the venue
↳ zipcode	string	Zipcode of the venue
↳ latitude	string	Latitude of the venue
↳ longitude	string	Longitude of the venue
↳ capacity	number	Seating capacity of the venue
↳ image_path	string	Image path of the venue
↳ city_name	string	Name of the city the venue is in
↳ surface	string	Surface type of the venue
↳ national_team	boolean	Whether the venue is used by the national team

Search Coaches

Search for football coaches by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The coach name to search for (e.g. Gerrard)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;teams)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
coaches	array	Array of coach objects matching the search query
↳ id	number	Unique id of the coach
↳ player_id	number	Player related to the coach
↳ sport_id	number	Sport of the coach
↳ country_id	number	Country of the coach
↳ nationality_id	number	Nationality of the coach
↳ city_id	number	Birth city of the coach
↳ common_name	string	Common name of the coach
↳ firstname	string	First name of the coach
↳ lastname	string	Last name of the coach
↳ name	string	Name of the coach
↳ display_name	string	Display name of the coach
↳ image_path	string	URL to the coach headshot
↳ height	number	Height of the coach in cm
↳ weight	number	Weight of the coach in kg
↳ date_of_birth	string	Date of birth of the coach
↳ gender	string	Gender of the coach

Search Fixtures

Search for football fixtures by name (participants) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The fixture name to search for (e.g. Celtic)
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;scores)
filters	string	No	Filters to apply (e.g. fixtureLeagues:501)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order fixtures by starting_at (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of fixture objects matching the search query
↳ id	number	Unique id of the fixture
↳ sport_id	number	Sport the fixture is played at
↳ league_id	number	League the fixture is played in
↳ season_id	number	Season the fixture is played in
↳ stage_id	number	Stage the fixture is played in
↳ group_id	number	Group the fixture is played in
↳ aggregate_id	number	Aggregate the fixture belongs to
↳ round_id	number	Round the fixture is played in
↳ state_id	number	State (status) of the fixture
↳ venue_id	number	Venue the fixture is played at
↳ name	string	Name of the fixture (participants)
↳ starting_at	string	Datetime the fixture starts
↳ result_info	string	Final result summary
↳ leg	string	Leg of the fixture (e.g. 1/1)
↳ details	string	Details about the fixture
↳ length	number	Length of the fixture in minutes
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Whether odds are available
↳ has_premium_odds	boolean	Whether premium odds are available
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Search Leagues

Search for football leagues by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The league name to search for (e.g. Premier)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;currentSeason)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order leagues (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of league objects matching the search query
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	number	Whether the league is active (1) or inactive (0)
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date the last fixture was played
↳ category	number	Importance category of the league (1-4)

Search Players

Search for football players by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The player name to search for (e.g. Tavernier)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;position;teams.team)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order players by id (asc or desc)

Output

Parameter	Type	Description
players	array	Array of player objects matching the search query
↳ id	number	Unique id of the player
↳ sport_id	number	Sport of the player
↳ country_id	number	Country of birth of the player
↳ nationality_id	number	Nationality of the player
↳ city_id	number	City of birth of the player
↳ position_id	number	Position of the player
↳ detailed_position_id	number	Detailed position of the player
↳ type_id	number	Type of the player
↳ common_name	string	Name the player is known for
↳ firstname	string	First name of the player
↳ lastname	string	Last name of the player
↳ name	string	Name of the player
↳ display_name	string	Display name of the player
↳ image_path	string	URL to the player headshot
↳ height	number	Height of the player in cm
↳ weight	number	Weight of the player in kg
↳ date_of_birth	string	Date of birth of the player
↳ gender	string	Gender of the player

Search Referees

Search for football referees by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The referee name to search for
include	string	No	Semicolon-separated relations to enrich the response (e.g. country)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
referees	array	Array of referee objects matching the search query
↳ id	number	Unique id of the referee
↳ sport_id	number	Sport of the referee
↳ country_id	number	Country of the referee
↳ nationality_id	number	Nationality of the referee
↳ city_id	number	Birth city of the referee
↳ common_name	string	Common name of the referee
↳ firstname	string	First name of the referee
↳ lastname	string	Last name of the referee
↳ name	string	Name of the referee
↳ display_name	string	Display name of the referee
↳ image_path	string	URL to the referee headshot
↳ height	number	Height of the referee in cm
↳ weight	number	Weight of the referee in kg
↳ date_of_birth	string	Date of birth of the referee
↳ gender	string	Gender of the referee

Search Rounds

Search for football rounds by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The round name to search for (e.g. 5)
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;season)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
rounds	array	Array of round objects matching the search query
↳ id	number	Unique id of the round
↳ sport_id	number	Sport of the round
↳ league_id	number	League of the round
↳ season_id	number	Season of the round
↳ stage_id	number	Stage of the round
↳ name	string	Name of the round
↳ finished	boolean	Whether the round is finished
↳ is_current	boolean	Whether the round is the current round
↳ starting_at	string	Start date of the round
↳ ending_at	string	End date of the round
↳ games_in_current_week	boolean	Whether the round has fixtures this week

Search Seasons

Search for football seasons by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The season name to search for (e.g. 2023/2024)
include	string	No	Semicolon-separated relations to enrich the response (e.g. league)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
seasons	array	Array of season objects matching the search query
↳ id	number	Unique id of the season
↳ sport_id	number	Sport of the season
↳ league_id	number	League of the season
↳ tie_breaker_rule_id	number	Tie-breaker rule of the season
↳ name	string	Name of the season (e.g. 2023/2024)
↳ finished	boolean	Whether the season is finished
↳ pending	boolean	Whether the season is pending
↳ is_current	boolean	Whether the season is the current season
↳ standing_method	string	Standing calculation method
↳ starting_at	string	Start date of the season
↳ ending_at	string	End date of the season
↳ standings_recalculated_at	string	Last standings recalculation time
↳ games_in_current_week	boolean	Whether the season has fixtures this week

Search Stages

Search for football stages by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The stage name to search for (e.g. Group)
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;season)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
stages	array	Array of stage objects matching the search query
↳ id	number	Unique id of the stage
↳ sport_id	number	Sport of the stage
↳ league_id	number	League of the stage
↳ season_id	number	Season of the stage
↳ type_id	number	Type of the stage
↳ name	string	Name of the stage
↳ sort_order	number	Sort order of the stage
↳ finished	boolean	Whether the stage is finished
↳ is_current	boolean	Whether the stage is the current stage
↳ starting_at	string	Start date of the stage
↳ ending_at	string	End date of the stage
↳ games_in_current_week	boolean	Whether the stage has fixtures this week

Search Teams

Search for football teams by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The team name to search for (e.g. Celtic)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;venue)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order teams by id (asc or desc)

Output

Parameter	Type	Description
teams	array	Array of team objects matching the search query
↳ id	number	Unique id of the team
↳ sport_id	number	Sport of the team
↳ country_id	number	Country of the team
↳ venue_id	number	Home venue of the team
↳ gender	string	Gender of the team
↳ name	string	Name of the team
↳ short_code	string	Short code of the team
↳ image_path	string	URL to the team logo
↳ founded	number	Founding year of the team
↳ type	string	Type of the team
↳ placeholder	boolean	Whether the team is a placeholder
↳ last_played_at	string	Date and time of the last played match

Search Venues

Search for football venues by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The venue name to search for (e.g. Celtic Park)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;city)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
venues	array	Array of venue objects matching the search query
↳ id	number	Unique id of the venue
↳ country_id	number	Country of the venue
↳ city_id	number	City of the venue
↳ name	string	Name of the venue
↳ address	string	Address of the venue
↳ zipcode	string	Zipcode of the venue
↳ latitude	string	Latitude of the venue
↳ longitude	string	Longitude of the venue
↳ capacity	number	Seating capacity of the venue
↳ image_path	string	Image path of the venue
↳ city_name	string	Name of the city the venue is in
↳ surface	string	Surface type of the venue
↳ national_team	boolean	Whether the venue is used by the national team

Motorsport

Get All Motorsport Fixtures

Retrieve all motorsport fixtures (sessions) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;results)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of motorsport fixture (session) objects
↳ id	number	Unique id of the fixture (session)
↳ sport_id	number	Sport of the fixture
↳ league_id	number	League the fixture is held in
↳ season_id	number	Season the fixture is held in
↳ stage_id	number	Stage (race weekend) the fixture is held in
↳ group_id	number	Not used in the Motorsport API
↳ aggregate_id	number	Not used in the Motorsport API
↳ round_id	number	Not used in the Motorsport API
↳ state_id	number	State the fixture is currently in
↳ venue_id	number	Venue (track) the fixture is held at
↳ name	string	Name of the fixture (e.g. Practice 1, Race)
↳ starting_at	string	Start date and time
↳ result_info	string	Final result info
↳ leg	string	Stage of the fixture (e.g. 2/3 for Practice 2)
↳ details	string	Details about the fixture
↳ length	number	Session length in minutes or total laps
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Not used in the Motorsport API
↳ has_premium_odds	boolean	Not used in the Motorsport API
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Current Leagues by Team

Retrieve the current motorsport leagues for a team by team ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team (constructor)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;seasons)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of current league objects for the team
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	boolean	Whether the league is active
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date of the last fixture held in the league
↳ category	number	Category of the league
↳ has_jerseys	boolean	Not used in the Motorsport API

Get Driver by ID

Retrieve a single motorsport driver by their ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
driverId	string	Yes	The unique id of the driver
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;teams)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
driver	object	The requested driver object
↳ id	number	Unique id of the driver (player_id in responses)
↳ sport_id	number	Sport of the driver
↳ country_id	number	Country of birth of the driver
↳ nationality_id	number	Nationality of the driver
↳ city_id	number	City of birth of the driver
↳ position_id	number	Position of the driver within the team
↳ detailed_position_id	number	Not used in the Motorsport API
↳ type_id	number	Not used in the Motorsport API
↳ common_name	string	Name the driver is known for
↳ firstname	string	First name of the driver
↳ lastname	string	Last name of the driver
↳ name	string	Name of the driver
↳ display_name	string	Display name of the driver
↳ image_path	string	URL to the driver headshot
↳ height	number	Height of the driver in cm
↳ weight	number	Weight of the driver in kg
↳ date_of_birth	string	Date of birth of the driver
↳ gender	string	Gender of the driver

Get All Driver Standings

Retrieve all driver championship standings from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;season)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
standings	array	Array of driver standing entries
↳ id	number	Unique id of the standing
↳ participant_id	number	Driver or team related to the standing
↳ sport_id	number	Sport related to the standing
↳ league_id	number	League related to the standing
↳ season_id	number	Season related to the standing
↳ stage_id	number	Stage related to the standing
↳ group_id	number	Not used in the Motorsport API
↳ round_id	number	Not used in the Motorsport API
↳ standing_rule_id	number	Not used in the Motorsport API
↳ position	number	Position of the participant in the standing
↳ result	string	Not used in the Motorsport API
↳ points	number	Points the participant has gathered

Get Driver Standings by Season

Retrieve the drivers championship standings for a season by season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;season)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
standings	array	Array of driver standing entries for the season
↳ id	number	Unique id of the standing
↳ participant_id	number	Driver or team related to the standing
↳ sport_id	number	Sport related to the standing
↳ league_id	number	League related to the standing
↳ season_id	number	Season related to the standing
↳ stage_id	number	Stage related to the standing
↳ group_id	number	Not used in the Motorsport API
↳ round_id	number	Not used in the Motorsport API
↳ standing_rule_id	number	Not used in the Motorsport API
↳ position	number	Position of the participant in the standing
↳ result	string	Not used in the Motorsport API
↳ points	number	Points the participant has gathered

Get Drivers

Retrieve all motorsport drivers from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;teams)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
drivers	array	Array of driver objects
↳ id	number	Unique id of the driver (player_id in responses)
↳ sport_id	number	Sport of the driver
↳ country_id	number	Country of birth of the driver
↳ nationality_id	number	Nationality of the driver
↳ city_id	number	City of birth of the driver
↳ position_id	number	Position of the driver within the team
↳ detailed_position_id	number	Not used in the Motorsport API
↳ type_id	number	Not used in the Motorsport API
↳ common_name	string	Name the driver is known for
↳ firstname	string	First name of the driver
↳ lastname	string	Last name of the driver
↳ name	string	Name of the driver
↳ display_name	string	Display name of the driver
↳ image_path	string	URL to the driver headshot
↳ height	number	Height of the driver in cm
↳ weight	number	Weight of the driver in kg
↳ date_of_birth	string	Date of birth of the driver
↳ gender	string	Gender of the driver

Get Drivers by Country

Retrieve all motorsport drivers for a country by country ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
countryId	string	Yes	The unique id of the country
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;teams)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
drivers	array	Array of driver objects for the country
↳ id	number	Unique id of the driver (player_id in responses)
↳ sport_id	number	Sport of the driver
↳ country_id	number	Country of birth of the driver
↳ nationality_id	number	Nationality of the driver
↳ city_id	number	City of birth of the driver
↳ position_id	number	Position of the driver within the team
↳ detailed_position_id	number	Not used in the Motorsport API
↳ type_id	number	Not used in the Motorsport API
↳ common_name	string	Name the driver is known for
↳ firstname	string	First name of the driver
↳ lastname	string	Last name of the driver
↳ name	string	Name of the driver
↳ display_name	string	Display name of the driver
↳ image_path	string	URL to the driver headshot
↳ height	number	Height of the driver in cm
↳ weight	number	Weight of the driver in kg
↳ date_of_birth	string	Date of birth of the driver
↳ gender	string	Gender of the driver

Get Drivers by Season

Retrieve all motorsport drivers for a season by season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;teams)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
drivers	array	Array of driver objects for the season
↳ id	number	Unique id of the driver (player_id in responses)
↳ sport_id	number	Sport of the driver
↳ country_id	number	Country of birth of the driver
↳ nationality_id	number	Nationality of the driver
↳ city_id	number	City of birth of the driver
↳ position_id	number	Position of the driver within the team
↳ detailed_position_id	number	Not used in the Motorsport API
↳ type_id	number	Not used in the Motorsport API
↳ common_name	string	Name the driver is known for
↳ firstname	string	First name of the driver
↳ lastname	string	Last name of the driver
↳ name	string	Name of the driver
↳ display_name	string	Display name of the driver
↳ image_path	string	URL to the driver headshot
↳ height	number	Height of the driver in cm
↳ weight	number	Weight of the driver in kg
↳ date_of_birth	string	Date of birth of the driver
↳ gender	string	Gender of the driver

Get Motorsport Fixture by ID

Retrieve a single motorsport fixture (session) by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;results;latestLaps;pitstops)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
fixture	object	The requested motorsport fixture (session) object
↳ id	number	Unique id of the fixture (session)
↳ sport_id	number	Sport of the fixture
↳ league_id	number	League the fixture is held in
↳ season_id	number	Season the fixture is held in
↳ stage_id	number	Stage (race weekend) the fixture is held in
↳ group_id	number	Not used in the Motorsport API
↳ aggregate_id	number	Not used in the Motorsport API
↳ round_id	number	Not used in the Motorsport API
↳ state_id	number	State the fixture is currently in
↳ venue_id	number	Venue (track) the fixture is held at
↳ name	string	Name of the fixture (e.g. Practice 1, Race)
↳ starting_at	string	Start date and time
↳ result_info	string	Final result info
↳ leg	string	Stage of the fixture (e.g. 2/3 for Practice 2)
↳ details	string	Details about the fixture
↳ length	number	Session length in minutes or total laps
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Not used in the Motorsport API
↳ has_premium_odds	boolean	Not used in the Motorsport API
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Motorsport Fixtures by Date

Retrieve motorsport fixtures (sessions) on a specific date (YYYY-MM-DD) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
date	string	Yes	The date to fetch fixtures for, in YYYY-MM-DD format
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;venue)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order fixtures by starting_at (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of motorsport fixture (session) objects for the requested date
↳ id	number	Unique id of the fixture (session)
↳ sport_id	number	Sport of the fixture
↳ league_id	number	League the fixture is held in
↳ season_id	number	Season the fixture is held in
↳ stage_id	number	Stage (race weekend) the fixture is held in
↳ group_id	number	Not used in the Motorsport API
↳ aggregate_id	number	Not used in the Motorsport API
↳ round_id	number	Not used in the Motorsport API
↳ state_id	number	State the fixture is currently in
↳ venue_id	number	Venue (track) the fixture is held at
↳ name	string	Name of the fixture (e.g. Practice 1, Race)
↳ starting_at	string	Start date and time
↳ result_info	string	Final result info
↳ leg	string	Stage of the fixture (e.g. 2/3 for Practice 2)
↳ details	string	Details about the fixture
↳ length	number	Session length in minutes or total laps
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Not used in the Motorsport API
↳ has_premium_odds	boolean	Not used in the Motorsport API
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Motorsport Fixtures by Date Range

Retrieve motorsport fixtures (sessions) between two dates (YYYY-MM-DD, max 100 days) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
startDate	string	Yes	The start date of the range, in YYYY-MM-DD format
endDate	string	Yes	The end date of the range, in YYYY-MM-DD format
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;venue)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order fixtures by starting_at (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of motorsport fixture (session) objects within the requested date range
↳ id	number	Unique id of the fixture (session)
↳ sport_id	number	Sport of the fixture
↳ league_id	number	League the fixture is held in
↳ season_id	number	Season the fixture is held in
↳ stage_id	number	Stage (race weekend) the fixture is held in
↳ group_id	number	Not used in the Motorsport API
↳ aggregate_id	number	Not used in the Motorsport API
↳ round_id	number	Not used in the Motorsport API
↳ state_id	number	State the fixture is currently in
↳ venue_id	number	Venue (track) the fixture is held at
↳ name	string	Name of the fixture (e.g. Practice 1, Race)
↳ starting_at	string	Start date and time
↳ result_info	string	Final result info
↳ leg	string	Stage of the fixture (e.g. 2/3 for Practice 2)
↳ details	string	Details about the fixture
↳ length	number	Session length in minutes or total laps
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Not used in the Motorsport API
↳ has_premium_odds	boolean	Not used in the Motorsport API
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Motorsport Fixtures by IDs

Retrieve multiple motorsport fixtures (sessions) by their IDs (max 50) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureIds	string	Yes	Comma-separated list of fixture ids (max 50, e.g. 19408487,19408480)
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;results)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of motorsport fixture (session) objects for the requested ids
↳ id	number	Unique id of the fixture (session)
↳ sport_id	number	Sport of the fixture
↳ league_id	number	League the fixture is held in
↳ season_id	number	Season the fixture is held in
↳ stage_id	number	Stage (race weekend) the fixture is held in
↳ group_id	number	Not used in the Motorsport API
↳ aggregate_id	number	Not used in the Motorsport API
↳ round_id	number	Not used in the Motorsport API
↳ state_id	number	State the fixture is currently in
↳ venue_id	number	Venue (track) the fixture is held at
↳ name	string	Name of the fixture (e.g. Practice 1, Race)
↳ starting_at	string	Start date and time
↳ result_info	string	Final result info
↳ leg	string	Stage of the fixture (e.g. 2/3 for Practice 2)
↳ details	string	Details about the fixture
↳ length	number	Session length in minutes or total laps
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Not used in the Motorsport API
↳ has_premium_odds	boolean	Not used in the Motorsport API
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Laps by Fixture

Retrieve all laps for a motorsport fixture (session) by fixture ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
laps	array	Array of lap objects for the fixture
↳ id	number	Unique id of the lap/pitstop
↳ fixture_id	number	Fixture related to the lap/pitstop
↳ lap_number	number	Lap number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the lap/pitstop
↳ is_latest	boolean	Whether it is the latest lap/pitstop

Get Laps by Fixture and Driver

Retrieve all laps for a motorsport fixture and driver from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
driverId	string	Yes	The unique id of the driver
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
laps	array	Array of lap objects for the fixture and driver
↳ id	number	Unique id of the lap/pitstop
↳ fixture_id	number	Fixture related to the lap/pitstop
↳ lap_number	number	Lap number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the lap/pitstop
↳ is_latest	boolean	Whether it is the latest lap/pitstop

Get Laps by Fixture and Lap Number

Retrieve all laps for a motorsport fixture and lap number from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
lapNumber	string	Yes	The lap number to retrieve
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
laps	array	Array of lap objects for the fixture and lap number
↳ id	number	Unique id of the lap/pitstop
↳ fixture_id	number	Fixture related to the lap/pitstop
↳ lap_number	number	Lap number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the lap/pitstop
↳ is_latest	boolean	Whether it is the latest lap/pitstop

Get Latest Laps by Fixture

Retrieve the latest laps for a motorsport fixture (session) by fixture ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
laps	array	Array of the latest lap objects for the fixture
↳ id	number	Unique id of the lap/pitstop
↳ fixture_id	number	Fixture related to the lap/pitstop
↳ lap_number	number	Lap number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the lap/pitstop
↳ is_latest	boolean	Whether it is the latest lap/pitstop

Get Latest Pitstops by Fixture

Retrieve the latest pitstops for a motorsport fixture (session) by fixture ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
pitstops	array	Array of the latest pitstop objects for the fixture
↳ id	number	Unique id of the lap/pitstop
↳ fixture_id	number	Fixture related to the lap/pitstop
↳ lap_number	number	Lap number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the lap/pitstop
↳ is_latest	boolean	Whether it is the latest lap/pitstop

Get Latest Stints by Fixture

Retrieve the latest tyre stints for a motorsport fixture (session) by fixture ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
stints	array	Array of the latest stint objects for the fixture
↳ id	number	Unique id of the stint
↳ fixture_id	number	Fixture related to the stint
↳ stint_number	number	Stint number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the stint
↳ is_latest	boolean	Whether it is the latest stint

Get Latest Updated Drivers

Retrieve the most recently updated motorsport drivers from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;teams)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
drivers	array	Array of recently updated driver objects
↳ id	number	Unique id of the driver (player_id in responses)
↳ sport_id	number	Sport of the driver
↳ country_id	number	Country of birth of the driver
↳ nationality_id	number	Nationality of the driver
↳ city_id	number	City of birth of the driver
↳ position_id	number	Position of the driver within the team
↳ detailed_position_id	number	Not used in the Motorsport API
↳ type_id	number	Not used in the Motorsport API
↳ common_name	string	Name the driver is known for
↳ firstname	string	First name of the driver
↳ lastname	string	Last name of the driver
↳ name	string	Name of the driver
↳ display_name	string	Display name of the driver
↳ image_path	string	URL to the driver headshot
↳ height	number	Height of the driver in cm
↳ weight	number	Weight of the driver in kg
↳ date_of_birth	string	Date of birth of the driver
↳ gender	string	Gender of the driver

Get Latest Updated Motorsport Fixtures

Retrieve the most recently updated motorsport fixtures (sessions) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;results)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of recently updated motorsport fixture (session) objects
↳ id	number	Unique id of the fixture (session)
↳ sport_id	number	Sport of the fixture
↳ league_id	number	League the fixture is held in
↳ season_id	number	Season the fixture is held in
↳ stage_id	number	Stage (race weekend) the fixture is held in
↳ group_id	number	Not used in the Motorsport API
↳ aggregate_id	number	Not used in the Motorsport API
↳ round_id	number	Not used in the Motorsport API
↳ state_id	number	State the fixture is currently in
↳ venue_id	number	Venue (track) the fixture is held at
↳ name	string	Name of the fixture (e.g. Practice 1, Race)
↳ starting_at	string	Start date and time
↳ result_info	string	Final result info
↳ leg	string	Stage of the fixture (e.g. 2/3 for Practice 2)
↳ details	string	Details about the fixture
↳ length	number	Session length in minutes or total laps
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Not used in the Motorsport API
↳ has_premium_odds	boolean	Not used in the Motorsport API
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get League by ID

Retrieve a single motorsport league by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
leagueId	string	Yes	The unique id of the league
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;seasons)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
league	object	The requested league object
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	boolean	Whether the league is active
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date of the last fixture held in the league
↳ category	number	Category of the league
↳ has_jerseys	boolean	Not used in the Motorsport API

Get All Leagues

Retrieve all motorsport leagues from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;seasons)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of league objects
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	boolean	Whether the league is active
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date of the last fixture held in the league
↳ category	number	Category of the league
↳ has_jerseys	boolean	Not used in the Motorsport API

Get Leagues by Country

Retrieve all motorsport leagues for a country by country ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
countryId	string	Yes	The unique id of the country
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;seasons)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of league objects for the country
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	boolean	Whether the league is active
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date of the last fixture held in the league
↳ category	number	Category of the league
↳ has_jerseys	boolean	Not used in the Motorsport API

Get Leagues by Fixture Date

Retrieve all motorsport leagues with fixtures on a specific date (YYYY-MM-DD) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
date	string	Yes	The date to fetch leagues for, in YYYY-MM-DD format
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;seasons)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of league objects with fixtures on the requested date
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	boolean	Whether the league is active
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date of the last fixture held in the league
↳ category	number	Category of the league
↳ has_jerseys	boolean	Not used in the Motorsport API

Get Leagues by Live

Retrieve all motorsport leagues that currently have live fixtures from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;seasons)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of league objects that currently have live fixtures
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	boolean	Whether the league is active
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date of the last fixture held in the league
↳ category	number	Category of the league
↳ has_jerseys	boolean	Not used in the Motorsport API

Get Leagues by Team

Retrieve all current and historical motorsport leagues for a team by team ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team (constructor)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;seasons)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of league objects for the team
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	boolean	Whether the league is active
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date of the last fixture held in the league
↳ category	number	Category of the league
↳ has_jerseys	boolean	Not used in the Motorsport API

Get Motorsport Livescores

Retrieve all live motorsport fixtures (sessions) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. participants;results)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
fixtures	array	Array of live motorsport fixture (session) objects
↳ id	number	Unique id of the fixture (session)
↳ sport_id	number	Sport of the fixture
↳ league_id	number	League the fixture is held in
↳ season_id	number	Season the fixture is held in
↳ stage_id	number	Stage (race weekend) the fixture is held in
↳ group_id	number	Not used in the Motorsport API
↳ aggregate_id	number	Not used in the Motorsport API
↳ round_id	number	Not used in the Motorsport API
↳ state_id	number	State the fixture is currently in
↳ venue_id	number	Venue (track) the fixture is held at
↳ name	string	Name of the fixture (e.g. Practice 1, Race)
↳ starting_at	string	Start date and time
↳ result_info	string	Final result info
↳ leg	string	Stage of the fixture (e.g. 2/3 for Practice 2)
↳ details	string	Details about the fixture
↳ length	number	Session length in minutes or total laps
↳ placeholder	boolean	Whether the fixture is a placeholder
↳ has_odds	boolean	Not used in the Motorsport API
↳ has_premium_odds	boolean	Not used in the Motorsport API
↳ starting_at_timestamp	number	UNIX timestamp of the start time

Get Pitstops by Fixture

Retrieve all pitstops for a motorsport fixture (session) by fixture ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
pitstops	array	Array of pitstop objects for the fixture
↳ id	number	Unique id of the lap/pitstop
↳ fixture_id	number	Fixture related to the lap/pitstop
↳ lap_number	number	Lap number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the lap/pitstop
↳ is_latest	boolean	Whether it is the latest lap/pitstop

Get Pitstops by Fixture and Driver

Retrieve all pitstops for a motorsport fixture and driver from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
driverId	string	Yes	The unique id of the driver
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
pitstops	array	Array of pitstop objects for the fixture and driver
↳ id	number	Unique id of the lap/pitstop
↳ fixture_id	number	Fixture related to the lap/pitstop
↳ lap_number	number	Lap number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the lap/pitstop
↳ is_latest	boolean	Whether it is the latest lap/pitstop

Get Pitstops by Fixture and Lap Number

Retrieve all pitstops for a motorsport fixture and lap number from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
lapNumber	string	Yes	The lap number to retrieve
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
pitstops	array	Array of pitstop objects for the fixture and lap number
↳ id	number	Unique id of the lap/pitstop
↳ fixture_id	number	Fixture related to the lap/pitstop
↳ lap_number	number	Lap number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the lap/pitstop
↳ is_latest	boolean	Whether it is the latest lap/pitstop

Get Race Results by Season and Driver

Retrieve race results (stages with fixtures, lineups and lineup details) for a season and driver from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
driverId	string	Yes	The unique id of the driver
include	string	No	Semicolon-separated relations to enrich the response
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
results	array	Array of stage objects for the season and driver, each including nested fixtures, lineups and lineup details
↳ id	number	Unique id of the stage (race weekend)
↳ sport_id	number	Sport of the stage
↳ league_id	number	League related to the stage
↳ season_id	number	Season related to the stage
↳ type_id	number	Type of the stage
↳ name	string	Name of the stage
↳ sort_order	number	Order of the stage
↳ finished	boolean	Whether the stage is finished
↳ is_current	boolean	Whether the stage is the current stage
↳ starting_at	string	Starting date of the stage
↳ ending_at	string	Ending date of the stage
↳ games_in_current_week	boolean	Not used in the Motorsport API
↳ tie_breaker_rule_id	number	Not used in the Motorsport API

Get Race Results by Season and Team

Retrieve race results (stages with fixtures, lineups and lineup details) for a season and team from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
teamId	string	Yes	The unique id of the team (constructor)
include	string	No	Semicolon-separated relations to enrich the response
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
results	array	Array of stage objects for the season and team, each including nested fixtures, lineups and lineup details
↳ id	number	Unique id of the stage (race weekend)
↳ sport_id	number	Sport of the stage
↳ league_id	number	League related to the stage
↳ season_id	number	Season related to the stage
↳ type_id	number	Type of the stage
↳ name	string	Name of the stage
↳ sort_order	number	Order of the stage
↳ finished	boolean	Whether the stage is finished
↳ is_current	boolean	Whether the stage is the current stage
↳ starting_at	string	Starting date of the stage
↳ ending_at	string	Ending date of the stage
↳ games_in_current_week	boolean	Not used in the Motorsport API
↳ tie_breaker_rule_id	number	Not used in the Motorsport API

Get Schedules by Season

Retrieve the full schedule (stages with nested fixtures and venues) for a season by season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
schedules	array	Array of stage objects for the season schedule, each including nested fixtures and venues
↳ id	number	Unique id of the stage (race weekend)
↳ sport_id	number	Sport of the stage
↳ league_id	number	League related to the stage
↳ season_id	number	Season related to the stage
↳ type_id	number	Type of the stage
↳ name	string	Name of the stage
↳ sort_order	number	Order of the stage
↳ finished	boolean	Whether the stage is finished
↳ is_current	boolean	Whether the stage is the current stage
↳ starting_at	string	Starting date of the stage
↳ ending_at	string	Ending date of the stage
↳ games_in_current_week	boolean	Not used in the Motorsport API
↳ tie_breaker_rule_id	number	Not used in the Motorsport API

Get Season by ID

Retrieve a single motorsport season by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;stages)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
season	object	The requested season object
↳ id	number	Unique id of the season
↳ sport_id	number	Sport of the season
↳ league_id	number	League of the season
↳ tie_breaker_rule_id	number	Not used in the Motorsport API
↳ name	string	Name of the season
↳ finished	boolean	Whether the season is finished
↳ pending	boolean	Whether the season is pending
↳ is_current	boolean	Whether the season is the current season
↳ starting_at	string	Starting date of the season
↳ ending_at	string	Ending date of the season
↳ standings_recalculated_at	string	Timestamp when standings were last updated
↳ games_in_current_week	boolean	Not used in the Motorsport API

Get All Seasons

Retrieve all motorsport seasons from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;stages)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
seasons	array	Array of season objects
↳ id	number	Unique id of the season
↳ sport_id	number	Sport of the season
↳ league_id	number	League of the season
↳ tie_breaker_rule_id	number	Not used in the Motorsport API
↳ name	string	Name of the season
↳ finished	boolean	Whether the season is finished
↳ pending	boolean	Whether the season is pending
↳ is_current	boolean	Whether the season is the current season
↳ starting_at	string	Starting date of the season
↳ ending_at	string	Ending date of the season
↳ standings_recalculated_at	string	Timestamp when standings were last updated
↳ games_in_current_week	boolean	Not used in the Motorsport API

Get Stage by ID

Retrieve a single motorsport stage (race weekend) by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
stageId	string	Yes	The unique id of the stage (race weekend)
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;season;fixtures)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
stage	object	The requested stage (race weekend) object
↳ id	number	Unique id of the stage (race weekend)
↳ sport_id	number	Sport of the stage
↳ league_id	number	League related to the stage
↳ season_id	number	Season related to the stage
↳ type_id	number	Type of the stage
↳ name	string	Name of the stage
↳ sort_order	number	Order of the stage
↳ finished	boolean	Whether the stage is finished
↳ is_current	boolean	Whether the stage is the current stage
↳ starting_at	string	Starting date of the stage
↳ ending_at	string	Ending date of the stage
↳ games_in_current_week	boolean	Not used in the Motorsport API
↳ tie_breaker_rule_id	number	Not used in the Motorsport API

Get All Stages

Retrieve all motorsport stages (race weekends) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;season;fixtures)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
stages	array	Array of stage (race weekend) objects
↳ id	number	Unique id of the stage (race weekend)
↳ sport_id	number	Sport of the stage
↳ league_id	number	League related to the stage
↳ season_id	number	Season related to the stage
↳ type_id	number	Type of the stage
↳ name	string	Name of the stage
↳ sort_order	number	Order of the stage
↳ finished	boolean	Whether the stage is finished
↳ is_current	boolean	Whether the stage is the current stage
↳ starting_at	string	Starting date of the stage
↳ ending_at	string	Ending date of the stage
↳ games_in_current_week	boolean	Not used in the Motorsport API
↳ tie_breaker_rule_id	number	Not used in the Motorsport API

Get Stages by Season

Retrieve all motorsport stages (race weekends) for a season by season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;season;fixtures)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
stages	array	Array of stage (race weekend) objects for the season
↳ id	number	Unique id of the stage (race weekend)
↳ sport_id	number	Sport of the stage
↳ league_id	number	League related to the stage
↳ season_id	number	Season related to the stage
↳ type_id	number	Type of the stage
↳ name	string	Name of the stage
↳ sort_order	number	Order of the stage
↳ finished	boolean	Whether the stage is finished
↳ is_current	boolean	Whether the stage is the current stage
↳ starting_at	string	Starting date of the stage
↳ ending_at	string	Ending date of the stage
↳ games_in_current_week	boolean	Not used in the Motorsport API
↳ tie_breaker_rule_id	number	Not used in the Motorsport API

Get State by ID

Retrieve a single motorsport fixture state by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
stateId	string	Yes	The unique id of the state
include	string	No	Semicolon-separated relations to enrich the response
filters	string	No	Filters to apply

Output

Parameter	Type	Description
state	object	The requested fixture state object
↳ id	number	Unique id of the state
↳ state	string	Abbreviation of the state
↳ name	string	Full name of the state
↳ short_name	string	Short name of the state
↳ developer_name	string	Name recommended for developers to use

Get All States

Retrieve all possible motorsport fixture states from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
states	array	Array of fixture state objects
↳ id	number	Unique id of the state
↳ state	string	Abbreviation of the state
↳ name	string	Full name of the state
↳ short_name	string	Short name of the state
↳ developer_name	string	Name recommended for developers to use

Get Stints by Fixture

Retrieve all tyre stints for a motorsport fixture (session) by fixture ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
stints	array	Array of stint objects for the fixture
↳ id	number	Unique id of the stint
↳ fixture_id	number	Fixture related to the stint
↳ stint_number	number	Stint number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the stint
↳ is_latest	boolean	Whether it is the latest stint

Get Stints by Fixture and Driver

Retrieve all tyre stints for a motorsport fixture and driver from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
driverId	string	Yes	The unique id of the driver
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
stints	array	Array of stint objects for the fixture and driver
↳ id	number	Unique id of the stint
↳ fixture_id	number	Fixture related to the stint
↳ stint_number	number	Stint number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the stint
↳ is_latest	boolean	Whether it is the latest stint

Get Stints by Fixture and Stint Number

Retrieve all tyre stints for a motorsport fixture and stint number from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture (session)
stintNumber	string	Yes	The stint number to retrieve
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;details)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
stints	array	Array of stint objects for the fixture and stint number
↳ id	number	Unique id of the stint
↳ fixture_id	number	Fixture related to the stint
↳ stint_number	number	Stint number in the fixture
↳ driver_number	number	Number of the driver
↳ participant_id	number	Driver related to the stint
↳ is_latest	boolean	Whether it is the latest stint

Get Team by ID

Retrieve a single motorsport team (constructor) by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
teamId	string	Yes	The unique id of the team (constructor)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;drivers)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
team	object	The requested team (constructor) object
↳ id	number	Unique id of the team
↳ sport_id	number	Sport of the team
↳ country_id	number	Country of the team
↳ venue_id	number	Not used in the Motorsport API
↳ gender	string	Gender of the team
↳ name	string	Name of the team (constructor)
↳ short_code	string	Short code of the team
↳ image_path	string	URL to the team logo
↳ founded	number	Founding year of the team
↳ type	string	Type of the team
↳ placeholder	boolean	Whether the team is a placeholder
↳ last_played_at	string	Date and time of the team's last session

Get All Team Standings

Retrieve all team (constructor) championship standings from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;season)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
standings	array	Array of team (constructor) standing entries
↳ id	number	Unique id of the standing
↳ participant_id	number	Driver or team related to the standing
↳ sport_id	number	Sport related to the standing
↳ league_id	number	League related to the standing
↳ season_id	number	Season related to the standing
↳ stage_id	number	Stage related to the standing
↳ group_id	number	Not used in the Motorsport API
↳ round_id	number	Not used in the Motorsport API
↳ standing_rule_id	number	Not used in the Motorsport API
↳ position	number	Position of the participant in the standing
↳ result	string	Not used in the Motorsport API
↳ points	number	Points the participant has gathered

Get Team Standings by Season

Retrieve the constructors championship standings for a season by season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. participant;season)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
standings	array	Array of team (constructor) standing entries for the season
↳ id	number	Unique id of the standing
↳ participant_id	number	Driver or team related to the standing
↳ sport_id	number	Sport related to the standing
↳ league_id	number	League related to the standing
↳ season_id	number	Season related to the standing
↳ stage_id	number	Stage related to the standing
↳ group_id	number	Not used in the Motorsport API
↳ round_id	number	Not used in the Motorsport API
↳ standing_rule_id	number	Not used in the Motorsport API
↳ position	number	Position of the participant in the standing
↳ result	string	Not used in the Motorsport API
↳ points	number	Points the participant has gathered

Get Teams

Retrieve all motorsport teams (constructors) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;drivers)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
teams	array	Array of team (constructor) objects
↳ id	number	Unique id of the team
↳ sport_id	number	Sport of the team
↳ country_id	number	Country of the team
↳ venue_id	number	Not used in the Motorsport API
↳ gender	string	Gender of the team
↳ name	string	Name of the team (constructor)
↳ short_code	string	Short code of the team
↳ image_path	string	URL to the team logo
↳ founded	number	Founding year of the team
↳ type	string	Type of the team
↳ placeholder	boolean	Whether the team is a placeholder
↳ last_played_at	string	Date and time of the team's last session

Get Teams by Country

Retrieve all motorsport teams (constructors) for a country by country ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
countryId	string	Yes	The unique id of the country
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;drivers)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
teams	array	Array of team (constructor) objects for the country
↳ id	number	Unique id of the team
↳ sport_id	number	Sport of the team
↳ country_id	number	Country of the team
↳ venue_id	number	Not used in the Motorsport API
↳ gender	string	Gender of the team
↳ name	string	Name of the team (constructor)
↳ short_code	string	Short code of the team
↳ image_path	string	URL to the team logo
↳ founded	number	Founding year of the team
↳ type	string	Type of the team
↳ placeholder	boolean	Whether the team is a placeholder
↳ last_played_at	string	Date and time of the team's last session

Get Teams by Season

Retrieve all motorsport teams (constructors) for a season by season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;drivers)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
teams	array	Array of team (constructor) objects for the season
↳ id	number	Unique id of the team
↳ sport_id	number	Sport of the team
↳ country_id	number	Country of the team
↳ venue_id	number	Not used in the Motorsport API
↳ gender	string	Gender of the team
↳ name	string	Name of the team (constructor)
↳ short_code	string	Short code of the team
↳ image_path	string	URL to the team logo
↳ founded	number	Founding year of the team
↳ type	string	Type of the team
↳ placeholder	boolean	Whether the team is a placeholder
↳ last_played_at	string	Date and time of the team's last session

Get Venue by ID

Retrieve a single motorsport venue (racing track) by its ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
venueId	string	Yes	The unique id of the venue (track)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;city)
filters	string	No	Filters to apply

Output

Parameter	Type	Description
venue	object	The requested venue (racing track) object
↳ id	number	Unique id of the venue (track)
↳ country_id	number	Country the venue is in
↳ city_id	number	City the venue is in
↳ name	string	Name of the venue/track
↳ address	string	Address of the venue
↳ zipcode	string	Zipcode of the venue
↳ latitude	string	Latitude of the venue
↳ longitude	string	Longitude of the venue
↳ capacity	number	Capacity of the venue
↳ image_path	string	URL to the track layout image
↳ city_name	string	Name of the city the venue is in
↳ surface	string	Surface of the venue
↳ national_team	boolean	Not used in the Motorsport API

Get Venues

Retrieve all motorsport venues (racing tracks) from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;city)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
venues	array	Array of venue (racing track) objects
↳ id	number	Unique id of the venue (track)
↳ country_id	number	Country the venue is in
↳ city_id	number	City the venue is in
↳ name	string	Name of the venue/track
↳ address	string	Address of the venue
↳ zipcode	string	Zipcode of the venue
↳ latitude	string	Latitude of the venue
↳ longitude	string	Longitude of the venue
↳ capacity	number	Capacity of the venue
↳ image_path	string	URL to the track layout image
↳ city_name	string	Name of the city the venue is in
↳ surface	string	Surface of the venue
↳ national_team	boolean	Not used in the Motorsport API

Get Venues by Season

Retrieve all motorsport venues (racing tracks) for a season by season ID from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
seasonId	string	Yes	The unique id of the season
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;city)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
venues	array	Array of venue (racing track) objects for the season
↳ id	number	Unique id of the venue (track)
↳ country_id	number	Country the venue is in
↳ city_id	number	City the venue is in
↳ name	string	Name of the venue/track
↳ address	string	Address of the venue
↳ zipcode	string	Zipcode of the venue
↳ latitude	string	Latitude of the venue
↳ longitude	string	Longitude of the venue
↳ capacity	number	Capacity of the venue
↳ image_path	string	URL to the track layout image
↳ city_name	string	Name of the city the venue is in
↳ surface	string	Surface of the venue
↳ national_team	boolean	Not used in the Motorsport API

Search Drivers

Search for motorsport drivers by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The driver name to search for (e.g. Verstappen)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;teams)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
drivers	array	Array of driver objects matching the search query
↳ id	number	Unique id of the driver (player_id in responses)
↳ sport_id	number	Sport of the driver
↳ country_id	number	Country of birth of the driver
↳ nationality_id	number	Nationality of the driver
↳ city_id	number	City of birth of the driver
↳ position_id	number	Position of the driver within the team
↳ detailed_position_id	number	Not used in the Motorsport API
↳ type_id	number	Not used in the Motorsport API
↳ common_name	string	Name the driver is known for
↳ firstname	string	First name of the driver
↳ lastname	string	Last name of the driver
↳ name	string	Name of the driver
↳ display_name	string	Display name of the driver
↳ image_path	string	URL to the driver headshot
↳ height	number	Height of the driver in cm
↳ weight	number	Weight of the driver in kg
↳ date_of_birth	string	Date of birth of the driver
↳ gender	string	Gender of the driver

Search Leagues

Search for motorsport leagues by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The league name to search for (e.g. Formula)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;seasons)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
leagues	array	Array of league objects matching the search query
↳ id	number	Unique id of the league
↳ sport_id	number	Sport of the league
↳ country_id	number	Country of the league
↳ name	string	Name of the league
↳ active	boolean	Whether the league is active
↳ short_code	string	Short code of the league
↳ image_path	string	URL to the league logo
↳ type	string	Type of the league
↳ sub_type	string	Subtype of the league
↳ last_played_at	string	Date of the last fixture held in the league
↳ category	number	Category of the league
↳ has_jerseys	boolean	Not used in the Motorsport API

Search Stages

Search for motorsport stages (race weekends) by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The stage name to search for (e.g. Monaco)
include	string	No	Semicolon-separated relations to enrich the response (e.g. league;season;fixtures)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
stages	array	Array of stage (race weekend) objects matching the search query
↳ id	number	Unique id of the stage (race weekend)
↳ sport_id	number	Sport of the stage
↳ league_id	number	League related to the stage
↳ season_id	number	Season related to the stage
↳ type_id	number	Type of the stage
↳ name	string	Name of the stage
↳ sort_order	number	Order of the stage
↳ finished	boolean	Whether the stage is finished
↳ is_current	boolean	Whether the stage is the current stage
↳ starting_at	string	Starting date of the stage
↳ ending_at	string	Ending date of the stage
↳ games_in_current_week	boolean	Not used in the Motorsport API
↳ tie_breaker_rule_id	number	Not used in the Motorsport API

Search Teams

Search for motorsport teams (constructors) by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The team name to search for (e.g. Bull)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;drivers)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
teams	array	Array of team (constructor) objects matching the search query
↳ id	number	Unique id of the team
↳ sport_id	number	Sport of the team
↳ country_id	number	Country of the team
↳ venue_id	number	Not used in the Motorsport API
↳ gender	string	Gender of the team
↳ name	string	Name of the team (constructor)
↳ short_code	string	Short code of the team
↳ image_path	string	URL to the team logo
↳ founded	number	Founding year of the team
↳ type	string	Type of the team
↳ placeholder	boolean	Whether the team is a placeholder
↳ last_played_at	string	Date and time of the team's last session

Search Venues

Search for motorsport venues (racing tracks) by name from Sportmonks

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The venue name to search for (e.g. Hungaroring)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;city)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
venues	array	Array of venue (racing track) objects matching the search query
↳ id	number	Unique id of the venue (track)
↳ country_id	number	Country the venue is in
↳ city_id	number	City the venue is in
↳ name	string	Name of the venue/track
↳ address	string	Address of the venue
↳ zipcode	string	Zipcode of the venue
↳ latitude	string	Latitude of the venue
↳ longitude	string	Longitude of the venue
↳ capacity	number	Capacity of the venue
↳ image_path	string	URL to the track layout image
↳ city_name	string	Name of the city the venue is in
↳ surface	string	Surface of the venue
↳ national_team	boolean	Not used in the Motorsport API

Odds

Get All Historical Odds

Retrieve all available historical (premium) pre-match odd values from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. odd)
filters	string	No	Filters to apply (e.g. winningOdds)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
historicalOdds	array	Array of historical premium odd value records
↳ id	number	Unique id of the history record
↳ odd_id	number	Premium odd this history record belongs to
↳ value	string	Historical decimal odds value
↳ probability	string	Implied probability at this point in time
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ bookmaker_update	string	Bookmaker's update timestamp for this record (UTC)

Get All In-play Odds

Retrieve all available live (in-play) odds from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12, bookmakers:2,14, IdAfter:oddID)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
odds	array	Array of in-play odd objects
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ external_id	number	External id of the odd
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label (e.g. 1, X, 2)
↳ value	string	Decimal odds value
↳ name	string	Outcome name
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ winning	boolean	Whether this is the winning outcome
↳ suspended	boolean	Whether the odd is suspended
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ participants	string	Participant ids related to the outcome

Get All Pre-match Odds

Retrieve all available pre-match odds from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12, bookmakers:2,14, winningOdds, IdAfter:oddID)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
odds	array	Array of pre-match odd objects
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label (e.g. 1, X, 2)
↳ value	string	Decimal odds value
↳ name	string	Outcome name (e.g. Home, Draw, Away)
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability (e.g. 48.78%)
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds (e.g. 31/15)
↳ american	string	American/moneyline odds (e.g. +104)
↳ winning	boolean	Whether this is the winning outcome
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ participants	string	Participant ids related to the outcome
↳ original_label	string	Original handicap value of the odd (handicap markets)

Get All Premium Odds

Retrieve all available premium (historical) pre-match odds from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12, bookmakers:2,14, IdAfter:oddID)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
premiumOdds	array	Array of premium odd objects
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label
↳ value	string	Decimal odds value
↳ name	string	Outcome name
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability (e.g. 29.85%)
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ created_at	string	Timestamp the odd was created (UTC)
↳ updated_at	string	Timestamp the odd was last updated (UTC)
↳ latest_bookmaker_update	string	Bookmaker's own last-update timestamp (UTC)

Get Bookmaker by ID

Retrieve a single bookmaker by its ID from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
bookmakerId	string	Yes	The unique id of the bookmaker

Output

Parameter	Type	Description
bookmaker	object	The requested bookmaker object
↳ id	number	Unique id of the bookmaker
↳ name	string	Name of the bookmaker
↳ logo	string	Logo of the bookmaker

Get Bookmaker Event IDs by Fixture

Retrieve bookmakers' own event ids mapped to a Sportmonks fixture via the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
bookmakerEvents	array	Array of bookmaker event mapping records for the fixture
↳ fixture_id	number	Sportmonks fixture id
↳ bookmaker_id	number	Id of the bookmaker
↳ bookmaker_name	string	Name of the bookmaker
↳ bookmaker_event_id	string	The fixture's event id at the bookmaker

Get Bookmakers

Retrieve all bookmakers from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
filters	string	No	Filters to apply (e.g. IdAfter:bookmakerID)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
bookmakers	array	Array of bookmaker objects
↳ id	number	Unique id of the bookmaker
↳ name	string	Name of the bookmaker
↳ logo	string	Logo of the bookmaker

Get Bookmakers by Fixture

Retrieve all bookmakers available for a fixture from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
bookmakers	array	Array of bookmaker objects available for the fixture
↳ id	number	Unique id of the bookmaker
↳ name	string	Name of the bookmaker
↳ logo	string	Logo of the bookmaker

Get In-play Odds by Fixture

Retrieve live (in-play) odds for a fixture by fixture ID from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12 or bookmakers:2,14 or winningOdds)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
odds	array	Array of in-play odd objects for the fixture
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ external_id	number	External id of the odd
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label (e.g. 1, X, 2)
↳ value	string	Decimal odds value
↳ name	string	Outcome name
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ winning	boolean	Whether this is the winning outcome
↳ suspended	boolean	Whether the odd is suspended
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ participants	string	Participant ids related to the outcome

Get In-play Odds by Fixture and Bookmaker

Retrieve live (in-play) odds for a fixture from a specific bookmaker via the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
bookmakerId	string	Yes	The unique id of the bookmaker
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12)

Output

Parameter	Type	Description
odds	array	Array of in-play odd objects for the fixture and bookmaker
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ external_id	number	External id of the odd
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label (e.g. 1, X, 2)
↳ value	string	Decimal odds value
↳ name	string	Outcome name
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ winning	boolean	Whether this is the winning outcome
↳ suspended	boolean	Whether the odd is suspended
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ participants	string	Participant ids related to the outcome

Get In-play Odds by Fixture and Market

Retrieve live (in-play) odds for a fixture on a specific market via the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
marketId	string	Yes	The unique id of the market
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. bookmakers:2,14)

Output

Parameter	Type	Description
odds	array	Array of in-play odd objects for the fixture and market
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ external_id	number	External id of the odd
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label (e.g. 1, X, 2)
↳ value	string	Decimal odds value
↳ name	string	Outcome name
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ winning	boolean	Whether this is the winning outcome
↳ suspended	boolean	Whether the odd is suspended
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ participants	string	Participant ids related to the outcome

Get Last Updated In-play Odds

Retrieve in-play odds updated in the last 10 seconds from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12 or bookmakers:2,14)

Output

Parameter	Type	Description
odds	array	Array of in-play odd objects updated in the last 10 seconds
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ external_id	number	External id of the odd
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label (e.g. 1, X, 2)
↳ value	string	Decimal odds value
↳ name	string	Outcome name
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ winning	boolean	Whether this is the winning outcome
↳ suspended	boolean	Whether the odd is suspended
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ participants	string	Participant ids related to the outcome

Get Last Updated Pre-match Odds

Retrieve pre-match odds updated in the last 10 seconds from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12 or bookmakers:2,14 or winningOdds)

Output

Parameter	Type	Description
odds	array	Array of pre-match odd objects updated in the last 10 seconds
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label (e.g. 1, X, 2)
↳ value	string	Decimal odds value
↳ name	string	Outcome name (e.g. Home, Draw, Away)
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability (e.g. 48.78%)
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds (e.g. 31/15)
↳ american	string	American/moneyline odds (e.g. +104)
↳ winning	boolean	Whether this is the winning outcome
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ participants	string	Participant ids related to the outcome
↳ original_label	string	Original handicap value of the odd (handicap markets)

Get Market by ID

Retrieve a single betting market by its ID from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
marketId	string	Yes	The unique id of the market

Output

Parameter	Type	Description
market	object	The requested market object
↳ id	number	Unique id of the market
↳ name	string	Name of the market
↳ developer_name	string	Developer (machine-readable) name of the market

Get Markets

Retrieve all betting markets from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
filters	string	No	Filters to apply (e.g. IdAfter:marketID)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
markets	array	Array of market objects
↳ id	number	Unique id of the market
↳ name	string	Name of the market
↳ developer_name	string	Developer (machine-readable) name of the market

Get Pre-match Odds by Fixture

Retrieve pre-match odds for a fixture by fixture ID from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12 or bookmakers:2,14 or winningOdds)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
odds	array	Array of pre-match odd objects for the fixture
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label (e.g. 1, X, 2)
↳ value	string	Decimal odds value
↳ name	string	Outcome name (e.g. Home, Draw, Away)
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability (e.g. 48.78%)
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds (e.g. 31/15)
↳ american	string	American/moneyline odds (e.g. +104)
↳ winning	boolean	Whether this is the winning outcome
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ participants	string	Participant ids related to the outcome
↳ original_label	string	Original handicap value of the odd (handicap markets)

Get Pre-match Odds by Fixture and Bookmaker

Retrieve pre-match odds for a fixture from a specific bookmaker via the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
bookmakerId	string	Yes	The unique id of the bookmaker
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12 or winningOdds)

Output

Parameter	Type	Description
odds	array	Array of pre-match odd objects for the fixture and bookmaker
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label (e.g. 1, X, 2)
↳ value	string	Decimal odds value
↳ name	string	Outcome name (e.g. Home, Draw, Away)
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability (e.g. 48.78%)
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds (e.g. 31/15)
↳ american	string	American/moneyline odds (e.g. +104)
↳ winning	boolean	Whether this is the winning outcome
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ participants	string	Participant ids related to the outcome
↳ original_label	string	Original handicap value of the odd (handicap markets)

Get Pre-match Odds by Fixture and Market

Retrieve pre-match odds for a fixture on a specific market via the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
marketId	string	Yes	The unique id of the market
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. bookmakers:2,14 or winningOdds)

Output

Parameter	Type	Description
odds	array	Array of pre-match odd objects for the fixture and market
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label (e.g. 1, X, 2)
↳ value	string	Decimal odds value
↳ name	string	Outcome name (e.g. Home, Draw, Away)
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability (e.g. 48.78%)
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds (e.g. 31/15)
↳ american	string	American/moneyline odds (e.g. +104)
↳ winning	boolean	Whether this is the winning outcome
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ participants	string	Participant ids related to the outcome
↳ original_label	string	Original handicap value of the odd (handicap markets)

Get Premium Odds by Fixture

Retrieve premium (historical) pre-match odds for a fixture from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12 or bookmakers:2,14)

Output

Parameter	Type	Description
premiumOdds	array	Array of premium odd objects for the fixture
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label
↳ value	string	Decimal odds value
↳ name	string	Outcome name
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability (e.g. 29.85%)
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ created_at	string	Timestamp the odd was created (UTC)
↳ updated_at	string	Timestamp the odd was last updated (UTC)
↳ latest_bookmaker_update	string	Bookmaker's own last-update timestamp (UTC)

Get Premium Odds by Fixture and Bookmaker

Retrieve premium pre-match odds for a fixture from a specific bookmaker via the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
bookmakerId	string	Yes	The unique id of the bookmaker
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12)

Output

Parameter	Type	Description
premiumOdds	array	Array of premium odd objects for the fixture and bookmaker
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label
↳ value	string	Decimal odds value
↳ name	string	Outcome name
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability (e.g. 29.85%)
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ created_at	string	Timestamp the odd was created (UTC)
↳ updated_at	string	Timestamp the odd was last updated (UTC)
↳ latest_bookmaker_update	string	Bookmaker's own last-update timestamp (UTC)

Get Premium Odds by Fixture and Market

Retrieve premium pre-match odds for a fixture on a specific market via the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fixtureId	string	Yes	The unique id of the fixture
marketId	string	Yes	The unique id of the market
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. bookmakers:2,14)

Output

Parameter	Type	Description
premiumOdds	array	Array of premium odd objects for the fixture and market
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label
↳ value	string	Decimal odds value
↳ name	string	Outcome name
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability (e.g. 29.85%)
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ created_at	string	Timestamp the odd was created (UTC)
↳ updated_at	string	Timestamp the odd was last updated (UTC)
↳ latest_bookmaker_update	string	Bookmaker's own last-update timestamp (UTC)

Get Updated Historical Odds Between Time Range

Retrieve historical (premium) odds updated between two UNIX timestamps (max 5 minutes) from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fromTimestamp	string	Yes	Start of the range as a UNIX timestamp (e.g. 1767225600)
toTimestamp	string	Yes	End of the range as a UNIX timestamp (max 5 minutes after the start)
include	string	No	Semicolon-separated relations to enrich the response (e.g. odd)
filters	string	No	Filters to apply (e.g. winningOdds)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
historicalOdds	array	Array of historical premium odd value records updated within the time range
↳ id	number	Unique id of the history record
↳ odd_id	number	Premium odd this history record belongs to
↳ value	string	Historical decimal odds value
↳ probability	string	Implied probability at this point in time
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ bookmaker_update	string	Bookmaker's update timestamp for this record (UTC)

Get Updated Premium Odds Between Time Range

Retrieve premium odds updated between two UNIX timestamps (max 5 minutes) from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
fromTimestamp	string	Yes	Start of the range as a UNIX timestamp (e.g. 1767225600)
toTimestamp	string	Yes	End of the range as a UNIX timestamp (max 5 minutes after the start)
include	string	No	Semicolon-separated relations to enrich the response (e.g. market;bookmaker)
filters	string	No	Filters to apply (e.g. markets:1,12 or bookmakers:2,14)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
premiumOdds	array	Array of premium odd objects updated within the time range
↳ id	number	Unique id of the odd
↳ fixture_id	number	Fixture the odd belongs to
↳ market_id	number	Market the odd belongs to
↳ bookmaker_id	number	Bookmaker offering the odd
↳ label	string	Outcome label
↳ value	string	Decimal odds value
↳ name	string	Outcome name
↳ sort_order	number	Sort order of the odd
↳ market_description	string	Description of the market
↳ probability	string	Implied probability (e.g. 29.85%)
↳ dp3	string	Decimal odds to 3 decimal places
↳ fractional	string	Fractional odds
↳ american	string	American/moneyline odds
↳ stopped	boolean	Whether the odd is stopped
↳ total	string	Total line for over/under markets
↳ handicap	string	Handicap line for handicap markets
↳ created_at	string	Timestamp the odd was created (UTC)
↳ updated_at	string	Timestamp the odd was last updated (UTC)
↳ latest_bookmaker_update	string	Bookmaker's own last-update timestamp (UTC)

Search Bookmakers

Search for bookmakers by name from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The bookmaker name to search for (e.g. bet365)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
bookmakers	array	Array of bookmaker objects matching the search query
↳ id	number	Unique id of the bookmaker
↳ name	string	Name of the bookmaker
↳ logo	string	Logo of the bookmaker

Search Markets

Search for betting markets by name from the Sportmonks Odds API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The market name to search for (e.g. Over/Under)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
markets	array	Array of market objects matching the search query
↳ id	number	Unique id of the market
↳ name	string	Name of the market
↳ developer_name	string	Developer (machine-readable) name of the market

Core (Reference)

Get Cities

Retrieve all cities from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. region)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
cities	array	Array of city objects
↳ id	number	Unique id of the city
↳ country_id	number	Country of the city
↳ region_id	number	Region id of the city
↳ name	string	Name of the city
↳ latitude	string	Latitude of the city
↳ longitude	string	Longitude of the city
↳ geonameid	number	Official geonameid of the city

Get City by ID

Retrieve a single city by its ID from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
cityId	string	Yes	The unique id of the city
include	string	No	Semicolon-separated relations to enrich the response (e.g. region)

Output

Parameter	Type	Description
city	object	The requested city object
↳ id	number	Unique id of the city
↳ country_id	number	Country of the city
↳ region_id	number	Region id of the city
↳ name	string	Name of the city
↳ latitude	string	Latitude of the city
↳ longitude	string	Longitude of the city
↳ geonameid	number	Official geonameid of the city

Get Continent by ID

Retrieve a single continent by its ID from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
continentId	string	Yes	The unique id of the continent
include	string	No	Semicolon-separated relations to enrich the response (e.g. countries)

Output

Parameter	Type	Description
continent	object	The requested continent object
↳ id	number	Unique id of the continent
↳ name	string	Name of the continent
↳ code	string	Short code of the continent

Get Continents

Retrieve all continents from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. countries)
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
continents	array	Array of continent objects
↳ id	number	Unique id of the continent
↳ name	string	Name of the continent
↳ code	string	Short code of the continent

Get Countries

Retrieve all countries from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. continent;regions)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
countries	array	Array of country objects
↳ id	number	Unique id of the country
↳ continent_id	number	Continent of the country
↳ name	string	Name of the country
↳ official_name	string	Official name of the country
↳ fifa_name	string	Official FIFA short code name
↳ iso2	string	Two letter country code
↳ iso3	string	Three letter country code
↳ latitude	string	Latitude position of the country
↳ longitude	string	Longitude position of the country
↳ geonameid	number	Official geonameid
↳ borders	array	Neighbouring countries (ISO3 codes)
↳ image_path	string	Image path to the country flag

Get Country by ID

Retrieve a single country by its ID from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
countryId	string	Yes	The unique id of the country
include	string	No	Semicolon-separated relations to enrich the response (e.g. continent;regions)

Output

Parameter	Type	Description
country	object	The requested country object
↳ id	number	Unique id of the country
↳ continent_id	number	Continent of the country
↳ name	string	Name of the country
↳ official_name	string	Official name of the country
↳ fifa_name	string	Official FIFA short code name
↳ iso2	string	Two letter country code
↳ iso3	string	Three letter country code
↳ latitude	string	Latitude position of the country
↳ longitude	string	Longitude position of the country
↳ geonameid	number	Official geonameid
↳ borders	array	Neighbouring countries (ISO3 codes)
↳ image_path	string	Image path to the country flag

Get All Entity Filters

Retrieve all available filters grouped per entity from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token

Output

Parameter	Type	Description
entityFilters	json	Map of entity name to its available filter names, e.g. {fixture: ["fixtureLeagues", "fixtureSeasons"], event: ["eventTypes"]}

Get My Usage

Retrieve your Sportmonks API usage aggregated per 5 minutes

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
usage	array	Array of API usage records aggregated per 5-minute period
↳ id	number	Identifier of the usage record
↳ endpoint	string	Identifier of the requested endpoint
↳ count	number	Total calls for the given timeframe
↳ entity	string	The entity the rate limit applies on
↳ remaining_requests	number	Amount of requests remaining for the entity in the hourly rate limit
↳ period_start	number	Timestamp representing the aggregation start time
↳ period_end	number	Timestamp representing the aggregation end time

Get Region by ID

Retrieve a single region by its ID from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
regionId	string	Yes	The unique id of the region
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;cities)

Output

Parameter	Type	Description
region	object	The requested region object
↳ id	number	Unique id of the region
↳ country_id	number	Country of the region
↳ name	string	Name of the region

Get Regions

Retrieve all regions from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;cities)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
regions	array	Array of region objects
↳ id	number	Unique id of the region
↳ country_id	number	Country of the region
↳ name	string	Name of the region

Get Timezones

Retrieve all supported time zones (IANA names) from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token

Output

Parameter	Type	Description
timezones	array	Array of supported IANA time zone names (e.g. Europe/London)

Get Type by ID

Retrieve a single type by its ID from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
typeId	string	Yes	The unique id of the type

Output

Parameter	Type	Description
type	object	The requested type object
↳ id	number	Unique id of the type
↳ parent_id	number	Parent type of the type
↳ name	string	Name of the type
↳ code	string	Code of the type
↳ developer_name	string	Developer name of the type
↳ group	string	Group the type falls under
↳ description	string	Description of the type

Get Type by Entity

Retrieve the available types grouped per entity from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token

Output

Parameter	Type	Description
typesByEntity	json	Map of entity name to its available types, e.g. {CoachStatisticDetail: {updated_at, types: [{id, name, code, developer_name, model_type, stat_group}]}}

Get Types

Retrieve all types (reference data describing events, statistics, positions, etc.) from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
types	array	Array of type objects
↳ id	number	Unique id of the type
↳ parent_id	number	Parent type of the type
↳ name	string	Name of the type
↳ code	string	Code of the type
↳ developer_name	string	Developer name of the type
↳ group	string	Group the type falls under
↳ description	string	Description of the type

Search Cities

Search for cities by name from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The city name to search for (e.g. London)
include	string	No	Semicolon-separated relations to enrich the response (e.g. region)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
cities	array	Array of city objects matching the search query
↳ id	number	Unique id of the city
↳ country_id	number	Country of the city
↳ region_id	number	Region id of the city
↳ name	string	Name of the city
↳ latitude	string	Latitude of the city
↳ longitude	string	Longitude of the city
↳ geonameid	number	Official geonameid of the city

Search Countries

Search for countries by name from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The country name to search for (e.g. Brazil)
include	string	No	Semicolon-separated relations to enrich the response (e.g. continent;regions)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
countries	array	Array of country objects matching the search query
↳ id	number	Unique id of the country
↳ continent_id	number	Continent of the country
↳ name	string	Name of the country
↳ official_name	string	Official name of the country
↳ fifa_name	string	Official FIFA short code name
↳ iso2	string	Two letter country code
↳ iso3	string	Three letter country code
↳ latitude	string	Latitude position of the country
↳ longitude	string	Longitude position of the country
↳ geonameid	number	Official geonameid
↳ borders	array	Neighbouring countries (ISO3 codes)
↳ image_path	string	Image path to the country flag

Search Regions

Search for regions by name from the Sportmonks Core API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Sportmonks API token
query	string	Yes	The region name to search for (e.g. Utrecht)
include	string	No	Semicolon-separated relations to enrich the response (e.g. country;cities)
filters	string	No	Filters to apply
per_page	string	No	Number of results per page (max 50, default 25)
page	string	No	Page number to retrieve
order	string	No	Order direction (asc or desc)

Output

Parameter	Type	Description
regions	array	Array of region objects matching the search query
↳ id	number	Unique id of the region
↳ country_id	number	Country of the region
↳ name	string	Name of the region