Sportmonks
App · 25 actions
Football data from Sportmonks: live scores, matches, league tables, top scorers, teams, squads, players and transfers, with triggers for kick-offs, goals, final whistles, transfers and table changes.
Actions
| Action | What it does |
|---|---|
| Get coach | Get one coach: name, date of birth and nationality. |
| Get head-to-head | List every match two teams have played against each other. |
| Get league | Get one league with its country and current season. |
| Get league table | Get a season's league table: each team's position, points, games played, won, drawn and lost, and goals. |
| Get live league table | Get a league's table as it stands right now, counting the scores of matches being played. |
| Get match | Get one match with its teams, score, status and kick-off time, and any extra detail chosen, such as goals and cards or line-ups. |
| Get player | Get one player: name, date of birth, height, nationality and position. |
| Get referee | Get one referee: name, date of birth and nationality. |
| Get stadium | Get one stadium: name, address, city, capacity and surface. |
| Get team | Get one team with its country, stadium and head coach. |
| Get team squad | List a team's players with their shirt numbers and positions: the squad now, or in one season. |
| Get top scorers | Get a season's top scorers, or the players with the most assists, yellow cards or red cards. |
| List latest transfers | List the transfers most recently added or changed, newest first, with the player and both clubs. |
| List leagues | List the leagues your Sportmonks plan covers, each with its country and current season. |
| List live matches | List the matches being played right now, with their score and status, or also those starting in the next 15 minutes and finished in the last 15. |
| List matches between dates | List the matches between two dates, at most 100 days apart, for one team or league if chosen. |
| List matches on a date | List the matches played or scheduled on one day. |
| List player transfers | List a player's moves between clubs, including loans. |
| List seasons | List a league's seasons, current and past, with their dates. |
| List team transfers | List the players a team has signed or let go. |
| List teams in a season | List the teams taking part in a season. |
| List transfers between dates | List the transfers dated between two days, at most 31 days apart. |
| Search matches | Find matches by name, such as 'Celtic vs Rangers' or a single team's name. |
| Search players | Find players by name. |
| Search teams | Find teams by name, in any league your plan covers. |
Get coach
Get one coach: name, date of birth and nationality.
Inputs
- Coach ID
coach_idtextRequired - The coach's Sportmonks id, such as a team's 'coach_id' from 'Get team'.
Outputs
coachobject- The coach
Example output
{
"coach": {
"common_name": "C. McGregor",
"country_id": 1161,
"date_of_birth": "1993-06-14",
"display_name": "Callum McGregor",
"firstname": "Callum",
"gender": "male",
"height": 178,
"id": 455361,
"image_path": "https://cdn.sportmonks.com/images/soccer/players/3/32035.png",
"lastname": "McGregor",
"name": "Callum McGregor",
"nationality_id": 1161,
"nationality_name": "Scotland",
"weight": 69
}
}Get head-to-head
List every match two teams have played against each other.
Inputs
- Team
club_idtextRequired - One of the two teams.
- Other team
other_club_idtextRequired - The team they played against.
- Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
fixtureslist- The matches
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
Example output
{
"count": 1,
"fixtures": [
{
"away_score": 0,
"away_team_id": 1371,
"away_team_name": "Kilmarnock",
"events": [],
"has_odds": true,
"home_score": 4,
"home_team_id": 53,
"home_team_name": "Celtic",
"id": 19146701,
"kickoff_date": "2024-08-04",
"kickoff_utc": "2024-08-04T15:30:00Z",
"league_id": 501,
"league_name": "Premiership",
"leg": "1/1",
"length": 90,
"lineups": [],
"name": "Celtic vs Kilmarnock",
"participants": [
{
"id": 53,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/21/53.png",
"meta": {
"location": "home",
"position": 1,
"winner": true
},
"name": "Celtic"
},
{
"id": 1371,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/27/1371.png",
"meta": {
"location": "away",
"position": 7,
"winner": false
},
"name": "Kilmarnock"
}
],
"referee_id": 14562,
"referees": [],
"result_info": "Celtic won after full-time.",
"round_id": 340573,
"scores": [
{
"description": "CURRENT",
"id": 13466001,
"participant_id": 53,
"score": {
"goals": 4,
"participant": "home"
}
},
{
"description": "CURRENT",
"id": 13466002,
"participant_id": 1371,
"score": {
"goals": 0,
"participant": "away"
}
}
],
"season_id": 23690,
"stage_id": 77471570,
"starting_at": "2024-08-04 15:30:00",
"starting_at_timestamp": 1722785400,
"state_id": 5,
"statistics": [],
"status": "Full Time",
"status_code": "FT",
"venue_id": 8909,
"winner_name": "Celtic"
}
],
"has_more": false,
"next_page": null,
"page": 1
}Get league
Get one league with its country and current season.
Inputs
- League
league_idtextRequired - The league.
Outputs
leagueobject- The league
Example output
{
"league": {
"active": true,
"country_id": 1161,
"country_name": "Scotland",
"current_season_end": "2026-05-17",
"current_season_id": 25598,
"current_season_name": "2025/2026",
"current_season_start": "2025-08-02",
"id": 501,
"image_path": "https://cdn.sportmonks.com/images/soccer/leagues/501.png",
"name": "Premiership",
"short_code": "SCO P",
"sub_type": "domestic",
"type": "league"
}
}Get league table
Get a season's league table: each team's position, points, games played, won, drawn and lost, and goals.
Inputs
- Season
season_idtextRequired - The season.
Outputs
countnumber- How many rows
standingslist- The table's rows, in order of position
Example output
{
"count": 1,
"standings": [
{
"drawn": 4,
"goal_difference": 51,
"goals_against": 27,
"goals_for": 78,
"group_id": null,
"id": 2622,
"league_id": 501,
"lost": 6,
"participant_id": 53,
"played": 33,
"points": 73,
"position": 1,
"result": "equal",
"round_id": 275092,
"season_id": 25598,
"stage_id": 77457866,
"team_id": 53,
"team_name": "Celtic",
"won": 23
}
]
}Get live league table
Get a league's table as it stands right now, counting the scores of matches being played.
Inputs
- League
league_idtextRequired - The league.
Outputs
countnumber- How many rows
standingslist- The table's rows, in order of position
Example output
{
"count": 1,
"standings": [
{
"drawn": 4,
"goal_difference": 51,
"goals_against": 27,
"goals_for": 78,
"group_id": null,
"id": 2622,
"league_id": 501,
"lost": 6,
"participant_id": 53,
"played": 33,
"points": 73,
"position": 1,
"result": "equal",
"round_id": 275092,
"season_id": 25598,
"stage_id": 77457866,
"team_id": 53,
"team_name": "Celtic",
"won": 23
}
]
}Get match
Get one match with its teams, score, status and kick-off time, and any extra detail chosen, such as goals and cards or line-ups.
Inputs
- Match ID
fixture_idtextRequired - The match's Sportmonks id, from a match list or an earlier step.
- Also include
detailslist - Extra detail for each match. Teams, score, status and league are always included. Some details need a paid Sportmonks plan.One or more of:
events(Goals, cards and substitutions),lineups(Line-ups),statistics(Match statistics),venue(Stadium),referees,tv_stations(TV channels),weather(Weather report),sidelined(Injured and suspended players),commentary(Text commentary).
Outputs
fixtureobject- The match
Example output
{
"fixture": {
"away_score": 0,
"away_team_id": 1371,
"away_team_name": "Kilmarnock",
"events": [],
"has_odds": true,
"home_score": 4,
"home_team_id": 53,
"home_team_name": "Celtic",
"id": 19146701,
"kickoff_date": "2024-08-04",
"kickoff_utc": "2024-08-04T15:30:00Z",
"league_id": 501,
"league_name": "Premiership",
"leg": "1/1",
"length": 90,
"lineups": [],
"name": "Celtic vs Kilmarnock",
"participants": [
{
"id": 53,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/21/53.png",
"meta": {
"location": "home",
"position": 1,
"winner": true
},
"name": "Celtic"
},
{
"id": 1371,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/27/1371.png",
"meta": {
"location": "away",
"position": 7,
"winner": false
},
"name": "Kilmarnock"
}
],
"referee_id": 14562,
"referees": [],
"result_info": "Celtic won after full-time.",
"round_id": 340573,
"scores": [
{
"description": "CURRENT",
"id": 13466001,
"participant_id": 53,
"score": {
"goals": 4,
"participant": "home"
}
},
{
"description": "CURRENT",
"id": 13466002,
"participant_id": 1371,
"score": {
"goals": 0,
"participant": "away"
}
}
],
"season_id": 23690,
"stage_id": 77471570,
"starting_at": "2024-08-04 15:30:00",
"starting_at_timestamp": 1722785400,
"state_id": 5,
"statistics": [],
"status": "Full Time",
"status_code": "FT",
"venue_id": 8909,
"winner_name": "Celtic"
}
}Get player
Get one player: name, date of birth, height, nationality and position.
Inputs
- Player ID
player_idtextRequired - The player's Sportmonks id, from 'Get team squad', 'Search players' or an earlier step.
Outputs
playerobject- The player
Example output
{
"player": {
"common_name": "C. McGregor",
"country_id": 1161,
"date_of_birth": "1993-06-14",
"detailed_position_id": 153,
"detailed_position_name": "Central Midfield",
"display_name": "Callum McGregor",
"firstname": "Callum",
"gender": "male",
"height": 178,
"id": 32035,
"image_path": "https://cdn.sportmonks.com/images/soccer/players/3/32035.png",
"lastname": "McGregor",
"name": "Callum McGregor",
"nationality_id": 1161,
"nationality_name": "Scotland",
"position_id": 26,
"position_name": "Midfielder",
"weight": 69
}
}Get referee
Get one referee: name, date of birth and nationality.
Inputs
- Referee ID
referee_idtextRequired - The referee's Sportmonks id, such as a match's 'referee_id' from 'Get match' with Referees included.
Outputs
refereeobject- The referee
Example output
{
"referee": {
"common_name": "C. McGregor",
"country_id": 1161,
"date_of_birth": "1993-06-14",
"display_name": "Callum McGregor",
"firstname": "Callum",
"gender": "male",
"height": 178,
"id": 14562,
"image_path": "https://cdn.sportmonks.com/images/soccer/players/3/32035.png",
"lastname": "McGregor",
"name": "Callum McGregor",
"nationality_id": 1161,
"nationality_name": "Scotland",
"weight": 69
}
}Get stadium
Get one stadium: name, address, city, capacity and surface.
Inputs
- Stadium ID
venue_idtextRequired - The stadium's Sportmonks id, such as a team's or a match's 'venue_id'.
Outputs
venueobject- The stadium
Example output
{
"venue": {
"address": "Kerrydale Street",
"capacity": 60411,
"city_label": "Glasgow",
"city_name": "Glasgow",
"country_id": 1161,
"country_name": "Scotland",
"id": 8909,
"image_path": "https://cdn.sportmonks.com/images/soccer/venues/13/8909.png",
"latitude": "55.849658",
"longitude": "-4.205584",
"name": "Celtic Park",
"surface": "grass"
}
}Get team
Get one team with its country, stadium and head coach.
Inputs
- Team
club_idtextRequired - The team.
Outputs
teamobject- The team
Example output
{
"team": {
"coach_id": 455361,
"country_id": 1161,
"country_name": "Scotland",
"founded": 1888,
"id": 53,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/21/53.png",
"name": "Celtic",
"short_code": "CEL",
"type": "domestic",
"venue_id": 8909,
"venue_name": "Celtic Park"
}
}Get team squad
List a team's players with their shirt numbers and positions: the squad now, or in one season.
Inputs
- Team
club_idtextRequired - The team.
- Season
season_idtext - A season, for that season's squad.
Outputs
countnumber- How many
squadlist- The players
Example output
{
"count": 1,
"squad": [
{
"end": null,
"id": 635741,
"jersey_number": 42,
"player_id": 32035,
"player_name": "Callum McGregor",
"position_id": 26,
"position_name": "Midfielder",
"start": "2013-07-01",
"team_id": 53
}
]
}Get top scorers
Get a season's top scorers, or the players with the most assists, yellow cards or red cards.
Inputs
- Season
season_idtextRequired - The season.
- Ranked by
categorytext - What the players are ranked by. Defaults to goals.One of:
goals(Goals (default)),assists,yellow_cards(Yellow cards),red_cards(Red cards). Default:goals. - Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
topscorerslist- The ranked players
Example output
{
"count": 1,
"has_more": false,
"next_page": null,
"page": 1,
"topscorers": [
{
"id": 1540848,
"participant_id": 53,
"player_id": 32035,
"player_name": "Callum McGregor",
"position": 1,
"season_id": 25598,
"team_id": 53,
"team_name": "Celtic",
"total": 21,
"type_id": 208
}
]
}List latest transfers
List the transfers most recently added or changed, newest first, with the player and both clubs.
Inputs
- Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
transferslist- The transfers
Example output
{
"count": 1,
"has_more": false,
"next_page": null,
"page": 1,
"transfers": [
{
"amount": null,
"career_ended": false,
"completed": true,
"date": "2025-07-01",
"from_team_id": 2432,
"from_team_name": "Preston North End",
"id": 186172,
"player_id": 32035,
"player_name": "Callum McGregor",
"to_team_id": 53,
"to_team_name": "Celtic",
"type_id": 219,
"type_name": "Transfer"
}
]
}List leagues
List the leagues your Sportmonks plan covers, each with its country and current season.
Inputs
- Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
has_moretrue/false- Whether there is a next page
leagueslist- The leagues
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
Example output
{
"count": 1,
"has_more": false,
"leagues": [
{
"active": true,
"country_id": 1161,
"country_name": "Scotland",
"current_season_end": "2026-05-17",
"current_season_id": 25598,
"current_season_name": "2025/2026",
"current_season_start": "2025-08-02",
"id": 501,
"image_path": "https://cdn.sportmonks.com/images/soccer/leagues/501.png",
"name": "Premiership",
"short_code": "SCO P",
"sub_type": "domestic",
"type": "league"
}
],
"next_page": null,
"page": 1
}List live matches
List the matches being played right now, with their score and status, or also those starting in the next 15 minutes and finished in the last 15.
Inputs
- Which matches
scopetext - Only matches being played, or also those about to start or just finished.One of:
in_play(Being played now (default)),around_now(Being played now, starting soon or just finished). Default:in_play. - League
league_idtext - Only matches in this league.
- Also include
detailslist - Extra detail for each match. Teams, score, status and league are always included. Some details need a paid Sportmonks plan.One or more of:
events(Goals, cards and substitutions),lineups(Line-ups),statistics(Match statistics),venue(Stadium),referees,tv_stations(TV channels),weather(Weather report),sidelined(Injured and suspended players),commentary(Text commentary).
Outputs
countnumber- How many
fixtureslist- The live matches
Example output
{
"count": 1,
"fixtures": [
{
"away_score": 0,
"away_team_id": 1371,
"away_team_name": "Kilmarnock",
"events": [],
"has_odds": true,
"home_score": 4,
"home_team_id": 53,
"home_team_name": "Celtic",
"id": 19146701,
"kickoff_date": "2024-08-04",
"kickoff_utc": "2024-08-04T15:30:00Z",
"league_id": 501,
"league_name": "Premiership",
"leg": "1/1",
"length": 90,
"lineups": [],
"name": "Celtic vs Kilmarnock",
"participants": [
{
"id": 53,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/21/53.png",
"meta": {
"location": "home",
"position": 1,
"winner": true
},
"name": "Celtic"
},
{
"id": 1371,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/27/1371.png",
"meta": {
"location": "away",
"position": 7,
"winner": false
},
"name": "Kilmarnock"
}
],
"referee_id": 14562,
"referees": [],
"result_info": "Celtic won after full-time.",
"round_id": 340573,
"scores": [
{
"description": "CURRENT",
"id": 13466001,
"participant_id": 53,
"score": {
"goals": 4,
"participant": "home"
}
},
{
"description": "CURRENT",
"id": 13466002,
"participant_id": 1371,
"score": {
"goals": 0,
"participant": "away"
}
}
],
"season_id": 23690,
"stage_id": 77471570,
"starting_at": "2024-08-04 15:30:00",
"starting_at_timestamp": 1722785400,
"state_id": 5,
"statistics": [],
"status": "Full Time",
"status_code": "FT",
"venue_id": 8909,
"winner_name": "Celtic"
}
]
}List matches between dates
List the matches between two dates, at most 100 days apart, for one team or league if chosen. Use it for a team's next or last games.
Inputs
- From
start_datedateRequired - The first day to include.
- Until
end_datedateRequired - The last day to include, at most 100 days after the first.
- Team
club_idtext - Only this team's matches.
- League
league_idtext - Only matches in this league.
- Order
ordertext - Sort by date. Defaults to oldest first.One of:
asc(Oldest first (default)),desc(Newest first). - Also include
detailslist - Extra detail for each match. Teams, score, status and league are always included. Some details need a paid Sportmonks plan.One or more of:
events(Goals, cards and substitutions),lineups(Line-ups),statistics(Match statistics),venue(Stadium),referees,tv_stations(TV channels),weather(Weather report),sidelined(Injured and suspended players),commentary(Text commentary). - Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
fixtureslist- The matches
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
Example output
{
"count": 1,
"fixtures": [
{
"away_score": 0,
"away_team_id": 1371,
"away_team_name": "Kilmarnock",
"events": [],
"has_odds": true,
"home_score": 4,
"home_team_id": 53,
"home_team_name": "Celtic",
"id": 19146701,
"kickoff_date": "2024-08-04",
"kickoff_utc": "2024-08-04T15:30:00Z",
"league_id": 501,
"league_name": "Premiership",
"leg": "1/1",
"length": 90,
"lineups": [],
"name": "Celtic vs Kilmarnock",
"participants": [
{
"id": 53,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/21/53.png",
"meta": {
"location": "home",
"position": 1,
"winner": true
},
"name": "Celtic"
},
{
"id": 1371,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/27/1371.png",
"meta": {
"location": "away",
"position": 7,
"winner": false
},
"name": "Kilmarnock"
}
],
"referee_id": 14562,
"referees": [],
"result_info": "Celtic won after full-time.",
"round_id": 340573,
"scores": [
{
"description": "CURRENT",
"id": 13466001,
"participant_id": 53,
"score": {
"goals": 4,
"participant": "home"
}
},
{
"description": "CURRENT",
"id": 13466002,
"participant_id": 1371,
"score": {
"goals": 0,
"participant": "away"
}
}
],
"season_id": 23690,
"stage_id": 77471570,
"starting_at": "2024-08-04 15:30:00",
"starting_at_timestamp": 1722785400,
"state_id": 5,
"statistics": [],
"status": "Full Time",
"status_code": "FT",
"venue_id": 8909,
"winner_name": "Celtic"
}
],
"has_more": false,
"next_page": null,
"page": 1
}List matches on a date
List the matches played or scheduled on one day.
Inputs
- Date
match_datedateRequired - The day of the matches.
- League
league_idtext - Only matches in this league.
- Also include
detailslist - Extra detail for each match. Teams, score, status and league are always included. Some details need a paid Sportmonks plan.One or more of:
events(Goals, cards and substitutions),lineups(Line-ups),statistics(Match statistics),venue(Stadium),referees,tv_stations(TV channels),weather(Weather report),sidelined(Injured and suspended players),commentary(Text commentary). - Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
fixtureslist- The matches
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
Example output
{
"count": 1,
"fixtures": [
{
"away_score": 0,
"away_team_id": 1371,
"away_team_name": "Kilmarnock",
"events": [],
"has_odds": true,
"home_score": 4,
"home_team_id": 53,
"home_team_name": "Celtic",
"id": 19146701,
"kickoff_date": "2024-08-04",
"kickoff_utc": "2024-08-04T15:30:00Z",
"league_id": 501,
"league_name": "Premiership",
"leg": "1/1",
"length": 90,
"lineups": [],
"name": "Celtic vs Kilmarnock",
"participants": [
{
"id": 53,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/21/53.png",
"meta": {
"location": "home",
"position": 1,
"winner": true
},
"name": "Celtic"
},
{
"id": 1371,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/27/1371.png",
"meta": {
"location": "away",
"position": 7,
"winner": false
},
"name": "Kilmarnock"
}
],
"referee_id": 14562,
"referees": [],
"result_info": "Celtic won after full-time.",
"round_id": 340573,
"scores": [
{
"description": "CURRENT",
"id": 13466001,
"participant_id": 53,
"score": {
"goals": 4,
"participant": "home"
}
},
{
"description": "CURRENT",
"id": 13466002,
"participant_id": 1371,
"score": {
"goals": 0,
"participant": "away"
}
}
],
"season_id": 23690,
"stage_id": 77471570,
"starting_at": "2024-08-04 15:30:00",
"starting_at_timestamp": 1722785400,
"state_id": 5,
"statistics": [],
"status": "Full Time",
"status_code": "FT",
"venue_id": 8909,
"winner_name": "Celtic"
}
],
"has_more": false,
"next_page": null,
"page": 1
}List player transfers
List a player's moves between clubs, including loans.
Inputs
- Player ID
player_idtextRequired - The player's Sportmonks id, from 'Get team squad', 'Search players' or an earlier step.
- Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
transferslist- The transfers
Example output
{
"count": 1,
"has_more": false,
"next_page": null,
"page": 1,
"transfers": [
{
"amount": null,
"career_ended": false,
"completed": true,
"date": "2025-07-01",
"from_team_id": 2432,
"from_team_name": "Preston North End",
"id": 186172,
"player_id": 32035,
"player_name": "Callum McGregor",
"to_team_id": 53,
"to_team_name": "Celtic",
"type_id": 219,
"type_name": "Transfer"
}
]
}List seasons
List a league's seasons, current and past, with their dates. Use a season's id for its table, top scorers or teams.
Inputs
- League
league_idtextRequired - The league.
- Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
seasonslist- The seasons
Example output
{
"count": 1,
"has_more": false,
"next_page": null,
"page": 1,
"seasons": [
{
"ending_at": "2026-05-17",
"finished": false,
"id": 25598,
"is_current": true,
"league": {
"id": 501,
"name": "Premiership"
},
"league_id": 501,
"name": "2025/2026",
"pending": false,
"starting_at": "2025-08-02"
}
]
}List team transfers
List the players a team has signed or let go.
Inputs
- Team
club_idtextRequired - The team.
- Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
transferslist- The transfers
Example output
{
"count": 1,
"has_more": false,
"next_page": null,
"page": 1,
"transfers": [
{
"amount": null,
"career_ended": false,
"completed": true,
"date": "2025-07-01",
"from_team_id": 2432,
"from_team_name": "Preston North End",
"id": 186172,
"player_id": 32035,
"player_name": "Callum McGregor",
"to_team_id": 53,
"to_team_name": "Celtic",
"type_id": 219,
"type_name": "Transfer"
}
]
}List teams in a season
List the teams taking part in a season.
Inputs
- Season
season_idtextRequired - The season.
- Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
teamslist- The teams
Example output
{
"count": 1,
"has_more": false,
"next_page": null,
"page": 1,
"teams": [
{
"coach_id": 455361,
"country_id": 1161,
"country_name": "Scotland",
"founded": 1888,
"id": 53,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/21/53.png",
"name": "Celtic",
"short_code": "CEL",
"type": "domestic",
"venue_id": 8909,
"venue_name": "Celtic Park"
}
]
}List transfers between dates
List the transfers dated between two days, at most 31 days apart.
Inputs
- From
start_datedateRequired - The first day to include.
- Until
end_datedateRequired - The last day to include, at most 31 days after the first.
- Order
ordertext - Sort by date. Defaults to oldest first.One of:
asc(Oldest first (default)),desc(Newest first). - Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
transferslist- The transfers
Example output
{
"count": 1,
"has_more": false,
"next_page": null,
"page": 1,
"transfers": [
{
"amount": null,
"career_ended": false,
"completed": true,
"date": "2025-07-01",
"from_team_id": 2432,
"from_team_name": "Preston North End",
"id": 186172,
"player_id": 32035,
"player_name": "Callum McGregor",
"to_team_id": 53,
"to_team_name": "Celtic",
"type_id": 219,
"type_name": "Transfer"
}
]
}Search matches
Find matches by name, such as 'Celtic vs Rangers' or a single team's name.
Inputs
- Name
nametextRequired - All or part of the name to look for.
- Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
fixtureslist- The matches
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
Example output
{
"count": 1,
"fixtures": [
{
"away_score": 0,
"away_team_id": 1371,
"away_team_name": "Kilmarnock",
"events": [],
"has_odds": true,
"home_score": 4,
"home_team_id": 53,
"home_team_name": "Celtic",
"id": 19146701,
"kickoff_date": "2024-08-04",
"kickoff_utc": "2024-08-04T15:30:00Z",
"league_id": 501,
"league_name": "Premiership",
"leg": "1/1",
"length": 90,
"lineups": [],
"name": "Celtic vs Kilmarnock",
"participants": [
{
"id": 53,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/21/53.png",
"meta": {
"location": "home",
"position": 1,
"winner": true
},
"name": "Celtic"
},
{
"id": 1371,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/27/1371.png",
"meta": {
"location": "away",
"position": 7,
"winner": false
},
"name": "Kilmarnock"
}
],
"referee_id": 14562,
"referees": [],
"result_info": "Celtic won after full-time.",
"round_id": 340573,
"scores": [
{
"description": "CURRENT",
"id": 13466001,
"participant_id": 53,
"score": {
"goals": 4,
"participant": "home"
}
},
{
"description": "CURRENT",
"id": 13466002,
"participant_id": 1371,
"score": {
"goals": 0,
"participant": "away"
}
}
],
"season_id": 23690,
"stage_id": 77471570,
"starting_at": "2024-08-04 15:30:00",
"starting_at_timestamp": 1722785400,
"state_id": 5,
"statistics": [],
"status": "Full Time",
"status_code": "FT",
"venue_id": 8909,
"winner_name": "Celtic"
}
],
"has_more": false,
"next_page": null,
"page": 1
}Search players
Find players by name.
Inputs
- Name
nametextRequired - All or part of the name to look for.
- Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
playerslist- The players
Example output
{
"count": 1,
"has_more": false,
"next_page": null,
"page": 1,
"players": [
{
"common_name": "C. McGregor",
"country_id": 1161,
"date_of_birth": "1993-06-14",
"detailed_position_id": 153,
"detailed_position_name": "Central Midfield",
"display_name": "Callum McGregor",
"firstname": "Callum",
"gender": "male",
"height": 178,
"id": 32035,
"image_path": "https://cdn.sportmonks.com/images/soccer/players/3/32035.png",
"lastname": "McGregor",
"name": "Callum McGregor",
"nationality_id": 1161,
"nationality_name": "Scotland",
"position_id": 26,
"position_name": "Midfielder",
"weight": 69
}
]
}Search teams
Find teams by name, in any league your plan covers.
Inputs
- Name
nametextRequired - All or part of the name to look for.
- Page
pagenumber - Which page of results, starting at 1 (the default).At least 1.
- Results per page
per_pagenumber - How many to return, 1 to 50. Sportmonks' default is 25.From 1 to 50.
Outputs
countnumber- How many on this page
has_moretrue/false- Whether there is a next page
next_pagenumber- The next page's number, empty on the last page
pagenumber- This page's number
teamslist- The teams
Example output
{
"count": 1,
"has_more": false,
"next_page": null,
"page": 1,
"teams": [
{
"coach_id": 455361,
"country_id": 1161,
"country_name": "Scotland",
"founded": 1888,
"id": 53,
"image_path": "https://cdn.sportmonks.com/images/soccer/teams/21/53.png",
"name": "Celtic",
"short_code": "CEL",
"type": "domestic",
"venue_id": 8909,
"venue_name": "Celtic Park"
}
]
}