Tools

Sportmonks

Access Sportmonks football, motorsport, odds, and reference data

Usage Instructions

Integrate the Sportmonks sports data APIs into the workflow from a single block. 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.

Tools

`sportmonks_football_expected_by_player`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_expected_by_team`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_all_commentaries`

Retrieve all textual commentaries available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_all_fixtures`

Retrieve all football fixtures available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_all_players`

Retrieve all football players available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_all_rivals`

Retrieve all teams with their rivals information from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_all_teams`

Retrieve all football teams available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_all_transfer_rumours`

Retrieve all transfer rumours available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_all_transfers`

Retrieve all transfers available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_brackets_by_season`

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

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)

`sportmonks_football_get_coach`

Retrieve a single football coach by their ID from Sportmonks

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

`sportmonks_football_get_coaches`

Retrieve all football coaches available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_coaches_by_country`

Retrieve all coaches for a country ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_commentaries_by_fixture`

Retrieve textual commentary for a fixture by fixture ID from Sportmonks

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

`sportmonks_football_get_current_leagues_by_team`

Retrieve all current leagues for a team ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_expected_lineups_by_player`

Retrieve the premium expected lineups for a player ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_expected_lineups_by_team`

Retrieve the premium expected lineups for a team ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_extended_team_squad`

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

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

`sportmonks_football_get_fixture`

Retrieve a single football fixture by its ID from Sportmonks

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

`sportmonks_football_get_fixtures_by_date`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_fixtures_by_date_range`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_fixtures_by_date_range_for_team`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_fixtures_by_ids`

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

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

`sportmonks_football_get_grouped_standings_by_round`

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

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

`sportmonks_football_get_head_to_head`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_inplay_livescores`

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

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

`sportmonks_football_get_latest_coaches`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_latest_fixtures`

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

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

`sportmonks_football_get_latest_livescores`

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

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

`sportmonks_football_get_latest_players`

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

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

`sportmonks_football_get_latest_totw`

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

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

`sportmonks_football_get_latest_transfers`

Retrieve the latest transfers available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_league`

Retrieve a single football league by its ID from Sportmonks

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

`sportmonks_football_get_leagues`

Retrieve all football leagues available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_leagues_by_country`

Retrieve all leagues for a country ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_leagues_by_date`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_leagues_by_team`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_live_leagues`

Retrieve all leagues that have fixtures currently being played from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_live_probabilities`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_live_probabilities_by_fixture`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_live_standings_by_league`

Retrieve the live standing table for a league ID from Sportmonks

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

`sportmonks_football_get_livescores`

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

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

`sportmonks_football_get_match_facts`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_match_facts_by_date_range`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_match_facts_by_fixture`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_match_facts_by_league`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_past_fixtures_by_tv_station`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_player`

Retrieve a single football player by their ID from Sportmonks

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

`sportmonks_football_get_players_by_country`

Retrieve all players for a country ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_postmatch_news`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_postmatch_news_by_season`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_predictability_by_league`

Retrieve the predictions model performance for a league ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_prematch_news`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_prematch_news_by_season`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_prematch_news_upcoming`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_probabilities`

Retrieve all prediction probabilities available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_probabilities_by_fixture`

Retrieve prediction probabilities for a fixture by fixture ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_referee`

Retrieve a single football referee by their ID from Sportmonks

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

`sportmonks_football_get_referees`

Retrieve all football referees available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_referees_by_country`

Retrieve all referees for a country ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_referees_by_season`

Retrieve all referees for a season ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_rivals_by_team`

Retrieve rival teams for a team by team ID from Sportmonks

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

`sportmonks_football_get_round`

Retrieve a single football round by its ID from Sportmonks

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

`sportmonks_football_get_round_statistics`

Retrieve all available statistics for a round ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_rounds`

Retrieve all football rounds available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_rounds_by_season`

Retrieve all rounds for a season ID from Sportmonks

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

`sportmonks_football_get_schedules_by_season`

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

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)

`sportmonks_football_get_schedules_by_season_and_team`

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

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

`sportmonks_football_get_schedules_by_team`

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

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)

`sportmonks_football_get_season`

Retrieve a single football season by its ID from Sportmonks

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

`sportmonks_football_get_seasons`

Retrieve all football seasons available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_seasons_by_team`

Retrieve all seasons for a team ID from Sportmonks

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

`sportmonks_football_get_stage`

Retrieve a single football stage by its ID from Sportmonks

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

`sportmonks_football_get_stage_statistics`

Retrieve all available statistics for a stage ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_stages`

Retrieve all football stages available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_stages_by_season`

Retrieve all stages for a season ID from Sportmonks

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

`sportmonks_football_get_standing_corrections_by_season`

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

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

`sportmonks_football_get_standings`

Retrieve all standings available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_standings_by_round`

Retrieve the full standing table for a round ID from Sportmonks

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

`sportmonks_football_get_standings_by_season`

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

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

`sportmonks_football_get_state`

Retrieve a single fixture state by its ID from Sportmonks

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

`sportmonks_football_get_states`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_team`

Retrieve a single football team by its ID from Sportmonks

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

`sportmonks_football_get_team_rankings`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_team_rankings_by_date`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_team_rankings_by_team`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_team_squad`

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

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

`sportmonks_football_get_team_squad_by_season`

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

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

`sportmonks_football_get_teams_by_country`

Retrieve all teams for a country ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_teams_by_season`

Retrieve all teams for a season ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_topscorers_by_season`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_topscorers_by_stage`

Retrieve topscorers for a stage by stage ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_totw`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_totw_by_round`

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

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

`sportmonks_football_get_transfer`

Retrieve a single transfer by its ID from Sportmonks

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

`sportmonks_football_get_transfer_rumour`

Retrieve a single transfer rumour by its ID from Sportmonks

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

`sportmonks_football_get_transfer_rumours_between_dates`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_transfer_rumours_by_player`

Retrieve transfer rumours for a player ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_transfer_rumours_by_team`

Retrieve transfer rumours for a team ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_transfers_between_dates`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_transfers_by_player`

Retrieve transfers for a player by player ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_transfers_by_team`

Retrieve transfers for a team by team ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_tv_station`

Retrieve a single TV station by its ID from Sportmonks

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

`sportmonks_football_get_tv_stations`

Retrieve all TV stations available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_tv_stations_by_fixture`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_upcoming_fixtures_by_market`

Retrieve all upcoming fixtures for a market ID from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_upcoming_fixtures_by_tv_station`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_value_bets`

Retrieve all value bets available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_value_bets_by_fixture`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_venue`

Retrieve a single football venue by its ID from Sportmonks

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

`sportmonks_football_get_venues`

Retrieve all football venues available within your Sportmonks subscription

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_get_venues_by_season`

Retrieve all venues for a season ID from Sportmonks

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

`sportmonks_football_search_coaches`

Search for football coaches by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_search_fixtures`

Search for football fixtures by name (participants) from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_search_leagues`

Search for football leagues by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_search_players`

Search for football players by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_search_referees`

Search for football referees by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_search_rounds`

Search for football rounds by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_search_seasons`

Search for football seasons by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_search_stages`

Search for football stages by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_search_teams`

Search for football teams by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_football_search_venues`

Search for football venues by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_all_fixtures`

Retrieve all motorsport fixtures (sessions) from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_current_leagues_by_team`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_driver`

Retrieve a single motorsport driver by their ID from Sportmonks

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

`sportmonks_motorsport_get_driver_standings`

Retrieve all driver championship standings from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_driver_standings_by_season`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_drivers`

Retrieve all motorsport drivers from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_drivers_by_country`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_drivers_by_season`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_fixture`

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

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

`sportmonks_motorsport_get_fixtures_by_date`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_fixtures_by_date_range`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_fixtures_by_ids`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_laps_by_fixture`

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

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

`sportmonks_motorsport_get_laps_by_fixture_and_driver`

Retrieve all laps for a motorsport fixture and driver from Sportmonks

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

`sportmonks_motorsport_get_laps_by_fixture_and_lap`

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

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

`sportmonks_motorsport_get_latest_laps_by_fixture`

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

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

`sportmonks_motorsport_get_latest_pitstops_by_fixture`

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

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

`sportmonks_motorsport_get_latest_stints_by_fixture`

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

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

`sportmonks_motorsport_get_latest_updated_drivers`

Retrieve the most recently updated motorsport drivers from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_latest_updated_fixtures`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_league`

Retrieve a single motorsport league by its ID from Sportmonks

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

`sportmonks_motorsport_get_leagues`

Retrieve all motorsport leagues from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_leagues_by_country`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_leagues_by_date`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_leagues_by_live`

Retrieve all motorsport leagues that currently have live fixtures from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_leagues_by_team`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_livescores`

Retrieve all live motorsport fixtures (sessions) from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_pitstops_by_fixture`

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

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

`sportmonks_motorsport_get_pitstops_by_fixture_and_driver`

Retrieve all pitstops for a motorsport fixture and driver from Sportmonks

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

`sportmonks_motorsport_get_pitstops_by_fixture_and_lap`

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

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

`sportmonks_motorsport_get_race_results_by_season_and_driver`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_race_results_by_season_and_team`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_schedules_by_season`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_season`

Retrieve a single motorsport season by its ID from Sportmonks

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

`sportmonks_motorsport_get_seasons`

Retrieve all motorsport seasons from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_stage`

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

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

`sportmonks_motorsport_get_stages`

Retrieve all motorsport stages (race weekends) from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_stages_by_season`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_state`

Retrieve a single motorsport fixture state by its ID from Sportmonks

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

`sportmonks_motorsport_get_states`

Retrieve all possible motorsport fixture states from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_stints_by_fixture`

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

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

`sportmonks_motorsport_get_stints_by_fixture_and_driver`

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

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

`sportmonks_motorsport_get_stints_by_fixture_and_stint`

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

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

`sportmonks_motorsport_get_team`

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

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

`sportmonks_motorsport_get_team_standings`

Retrieve all team (constructor) championship standings from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_team_standings_by_season`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_teams`

Retrieve all motorsport teams (constructors) from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_teams_by_country`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_teams_by_season`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_venue`

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

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

`sportmonks_motorsport_get_venues`

Retrieve all motorsport venues (racing tracks) from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_get_venues_by_season`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_search_drivers`

Search for motorsport drivers by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_search_leagues`

Search for motorsport leagues by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_search_stages`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_search_teams`

Search for motorsport teams (constructors) by name from Sportmonks

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_motorsport_search_venues`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_all_historical_odds`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_all_inplay_odds`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_all_pre_match_odds`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_all_premium_odds`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_bookmaker`

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

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

`sportmonks_odds_get_bookmaker_event_ids_by_fixture`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_bookmakers`

Retrieve all bookmakers from the Sportmonks Odds API

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_bookmakers_by_fixture`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_inplay_odds_by_fixture`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_inplay_odds_by_fixture_and_bookmaker`

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

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

`sportmonks_odds_get_inplay_odds_by_fixture_and_market`

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

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

`sportmonks_odds_get_last_updated_inplay_odds`

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

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

`sportmonks_odds_get_last_updated_pre_match_odds`

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

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

`sportmonks_odds_get_market`

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

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

`sportmonks_odds_get_markets`

Retrieve all betting markets from the Sportmonks Odds API

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_pre_match_odds_by_fixture`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_pre_match_odds_by_fixture_and_bookmaker`

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

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

`sportmonks_odds_get_pre_match_odds_by_fixture_and_market`

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

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

`sportmonks_odds_get_premium_odds_by_fixture`

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

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

`sportmonks_odds_get_premium_odds_by_fixture_and_bookmaker`

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

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

`sportmonks_odds_get_premium_odds_by_fixture_and_market`

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

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

`sportmonks_odds_get_updated_historical_odds_between`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_get_updated_premium_odds_between`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_search_bookmakers`

Search for bookmakers by name from the Sportmonks Odds API

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_odds_search_markets`

Search for betting markets by name from the Sportmonks Odds API

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_core_get_cities`

Retrieve all cities from the Sportmonks Core API

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_core_get_city`

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

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

`sportmonks_core_get_continent`

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

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

`sportmonks_core_get_continents`

Retrieve all continents from the Sportmonks Core API

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_core_get_countries`

Retrieve all countries from the Sportmonks Core API

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_core_get_country`

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

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

`sportmonks_core_get_entity_filters`

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

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"]}

`sportmonks_core_get_my_usage`

Retrieve your Sportmonks API usage aggregated per 5 minutes

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_core_get_region`

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

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

`sportmonks_core_get_regions`

Retrieve all regions from the Sportmonks Core API

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_core_get_timezones`

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

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)

`sportmonks_core_get_type`

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

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

`sportmonks_core_get_type_by_entity`

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

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}]}}

`sportmonks_core_get_types`

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

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_core_search_cities`

Search for cities by name from the Sportmonks Core API

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_core_search_countries`

Search for countries by name from the Sportmonks Core API

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

`sportmonks_core_search_regions`

Search for regions by name from the Sportmonks Core API

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
`pagination`	object	Pagination metadata (present on paginated endpoints)

Notes

Category: tools
Type: sportmonks

On this page

On this page

Usage Instructions

sportmonks_football_expected_by_player

sportmonks_football_expected_by_team

sportmonks_football_get_all_commentaries

sportmonks_football_get_all_fixtures

sportmonks_football_get_all_players

sportmonks_football_get_all_rivals

sportmonks_football_get_all_teams

sportmonks_football_get_all_transfer_rumours

sportmonks_football_get_all_transfers

sportmonks_football_get_brackets_by_season

sportmonks_football_get_coach

sportmonks_football_get_coaches

sportmonks_football_get_coaches_by_country

sportmonks_football_get_commentaries_by_fixture

sportmonks_football_get_current_leagues_by_team

sportmonks_football_get_expected_lineups_by_player

sportmonks_football_get_expected_lineups_by_team

sportmonks_football_get_extended_team_squad

sportmonks_football_get_fixture

sportmonks_football_get_fixtures_by_date

sportmonks_football_get_fixtures_by_date_range

sportmonks_football_get_fixtures_by_date_range_for_team

sportmonks_football_get_fixtures_by_ids

sportmonks_football_get_grouped_standings_by_round

sportmonks_football_get_head_to_head

sportmonks_football_get_inplay_livescores

sportmonks_football_get_latest_coaches

sportmonks_football_get_latest_fixtures

sportmonks_football_get_latest_livescores

sportmonks_football_get_latest_players

sportmonks_football_get_latest_totw

sportmonks_football_get_latest_transfers

sportmonks_football_get_league

sportmonks_football_get_leagues

sportmonks_football_get_leagues_by_country

sportmonks_football_get_leagues_by_date

sportmonks_football_get_leagues_by_team

sportmonks_football_get_live_leagues

sportmonks_football_get_live_probabilities

sportmonks_football_get_live_probabilities_by_fixture

sportmonks_football_get_live_standings_by_league

sportmonks_football_get_livescores

sportmonks_football_get_match_facts

sportmonks_football_get_match_facts_by_date_range

sportmonks_football_get_match_facts_by_fixture

sportmonks_football_get_match_facts_by_league

sportmonks_football_get_past_fixtures_by_tv_station

sportmonks_football_get_player

sportmonks_football_get_players_by_country

sportmonks_football_get_postmatch_news

sportmonks_football_get_postmatch_news_by_season

sportmonks_football_get_predictability_by_league

sportmonks_football_get_prematch_news

sportmonks_football_get_prematch_news_by_season

sportmonks_football_get_prematch_news_upcoming

sportmonks_football_get_probabilities

sportmonks_football_get_probabilities_by_fixture

sportmonks_football_get_referee

sportmonks_football_get_referees

sportmonks_football_get_referees_by_country

sportmonks_football_get_referees_by_season

sportmonks_football_get_rivals_by_team

sportmonks_football_get_round

sportmonks_football_get_round_statistics

sportmonks_football_get_rounds

sportmonks_football_get_rounds_by_season

sportmonks_football_get_schedules_by_season

sportmonks_football_get_schedules_by_season_and_team

sportmonks_football_get_schedules_by_team

sportmonks_football_get_season

sportmonks_football_get_seasons

sportmonks_football_get_seasons_by_team

sportmonks_football_get_stage

sportmonks_football_get_stage_statistics

sportmonks_football_get_stages

sportmonks_football_get_stages_by_season

sportmonks_football_get_standing_corrections_by_season

sportmonks_football_get_standings

sportmonks_football_get_standings_by_round

sportmonks_football_get_standings_by_season

sportmonks_football_get_state

sportmonks_football_get_states

sportmonks_football_get_team

sportmonks_football_get_team_rankings

sportmonks_football_get_team_rankings_by_date

sportmonks_football_get_team_rankings_by_team

sportmonks_football_get_team_squad

sportmonks_football_get_team_squad_by_season

sportmonks_football_get_teams_by_country

sportmonks_football_get_teams_by_season

sportmonks_football_get_topscorers_by_season

sportmonks_football_get_topscorers_by_stage

sportmonks_football_get_totw

sportmonks_football_get_totw_by_round

sportmonks_football_get_transfer

sportmonks_football_get_transfer_rumour

sportmonks_football_get_transfer_rumours_between_dates

sportmonks_football_get_transfer_rumours_by_player

sportmonks_football_get_transfer_rumours_by_team

sportmonks_football_get_transfers_between_dates

sportmonks_football_get_transfers_by_player

sportmonks_football_get_transfers_by_team

sportmonks_football_get_tv_station

sportmonks_football_get_tv_stations

sportmonks_football_get_tv_stations_by_fixture

sportmonks_football_get_upcoming_fixtures_by_market

sportmonks_football_get_upcoming_fixtures_by_tv_station

sportmonks_football_get_value_bets

sportmonks_football_get_value_bets_by_fixture

sportmonks_football_get_venue

sportmonks_football_get_venues

sportmonks_football_get_venues_by_season

sportmonks_football_search_coaches

sportmonks_football_search_fixtures

sportmonks_football_search_leagues

sportmonks_football_search_players

sportmonks_football_search_referees

sportmonks_football_search_rounds

sportmonks_football_search_seasons

sportmonks_football_search_stages

sportmonks_football_search_teams

sportmonks_football_search_venues

sportmonks_motorsport_get_all_fixtures

sportmonks_motorsport_get_current_leagues_by_team

sportmonks_motorsport_get_driver

sportmonks_motorsport_get_driver_standings

sportmonks_motorsport_get_driver_standings_by_season

sportmonks_motorsport_get_drivers

sportmonks_motorsport_get_drivers_by_country

sportmonks_motorsport_get_drivers_by_season

sportmonks_motorsport_get_fixture

sportmonks_motorsport_get_fixtures_by_date

sportmonks_motorsport_get_fixtures_by_date_range

sportmonks_motorsport_get_fixtures_by_ids

sportmonks_motorsport_get_laps_by_fixture

sportmonks_motorsport_get_laps_by_fixture_and_driver

sportmonks_motorsport_get_laps_by_fixture_and_lap

sportmonks_motorsport_get_latest_laps_by_fixture

sportmonks_motorsport_get_latest_pitstops_by_fixture

sportmonks_motorsport_get_latest_stints_by_fixture

sportmonks_motorsport_get_latest_updated_drivers

sportmonks_motorsport_get_latest_updated_fixtures

sportmonks_motorsport_get_league

sportmonks_motorsport_get_leagues

sportmonks_motorsport_get_leagues_by_country

sportmonks_motorsport_get_leagues_by_date

sportmonks_motorsport_get_leagues_by_live

sportmonks_motorsport_get_leagues_by_team

sportmonks_motorsport_get_livescores

sportmonks_motorsport_get_pitstops_by_fixture

sportmonks_motorsport_get_pitstops_by_fixture_and_driver

sportmonks_motorsport_get_pitstops_by_fixture_and_lap

sportmonks_motorsport_get_race_results_by_season_and_driver

sportmonks_motorsport_get_race_results_by_season_and_team

sportmonks_motorsport_get_schedules_by_season

sportmonks_motorsport_get_season

sportmonks_motorsport_get_seasons

sportmonks_motorsport_get_stage

sportmonks_motorsport_get_stages

sportmonks_motorsport_get_stages_by_season

sportmonks_motorsport_get_state

sportmonks_motorsport_get_states

sportmonks_motorsport_get_stints_by_fixture

sportmonks_motorsport_get_stints_by_fixture_and_driver

sportmonks_motorsport_get_stints_by_fixture_and_stint

sportmonks_motorsport_get_team

sportmonks_motorsport_get_team_standings

sportmonks_motorsport_get_team_standings_by_season

sportmonks_motorsport_get_teams

sportmonks_motorsport_get_teams_by_country

sportmonks_motorsport_get_teams_by_season

sportmonks_motorsport_get_venue

sportmonks_motorsport_get_venues

sportmonks_motorsport_get_venues_by_season

sportmonks_motorsport_search_drivers

sportmonks_motorsport_search_leagues

sportmonks_motorsport_search_stages

sportmonks_motorsport_search_teams

sportmonks_motorsport_search_venues

sportmonks_odds_get_all_historical_odds

sportmonks_odds_get_all_inplay_odds

sportmonks_odds_get_all_pre_match_odds

sportmonks_odds_get_all_premium_odds

sportmonks_odds_get_bookmaker

sportmonks_odds_get_bookmaker_event_ids_by_fixture

sportmonks_odds_get_bookmakers

sportmonks_odds_get_bookmakers_by_fixture

sportmonks_odds_get_inplay_odds_by_fixture

sportmonks_odds_get_inplay_odds_by_fixture_and_bookmaker

sportmonks_odds_get_inplay_odds_by_fixture_and_market

sportmonks_odds_get_last_updated_inplay_odds

sportmonks_odds_get_last_updated_pre_match_odds

sportmonks_odds_get_market

sportmonks_odds_get_markets

sportmonks_odds_get_pre_match_odds_by_fixture

sportmonks_odds_get_pre_match_odds_by_fixture_and_bookmaker

sportmonks_odds_get_pre_match_odds_by_fixture_and_market

sportmonks_odds_get_premium_odds_by_fixture

sportmonks_odds_get_premium_odds_by_fixture_and_bookmaker

sportmonks_odds_get_premium_odds_by_fixture_and_market

sportmonks_odds_get_updated_historical_odds_between

sportmonks_odds_get_updated_premium_odds_between

sportmonks_odds_search_bookmakers

sportmonks_odds_search_markets

sportmonks_core_get_cities

sportmonks_core_get_city

sportmonks_core_get_continent

sportmonks_core_get_continents

sportmonks_core_get_countries

sportmonks_core_get_country

sportmonks_core_get_entity_filters

sportmonks_core_get_my_usage

sportmonks_core_get_region

sportmonks_core_get_regions

sportmonks_core_get_timezones

sportmonks_core_get_type

sportmonks_core_get_type_by_entity

sportmonks_core_get_types

sportmonks_core_search_cities

sportmonks_core_search_countries

sportmonks_core_search_regions

Sportmonks