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

ActionWhat it does
Get coachGet one coach: name, date of birth and nationality.
Get head-to-headList every match two teams have played against each other.
Get leagueGet one league with its country and current season.
Get league tableGet a season's league table: each team's position, points, games played, won, drawn and lost, and goals.
Get live league tableGet a league's table as it stands right now, counting the scores of matches being played.
Get matchGet 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 playerGet one player: name, date of birth, height, nationality and position.
Get refereeGet one referee: name, date of birth and nationality.
Get stadiumGet one stadium: name, address, city, capacity and surface.
Get teamGet one team with its country, stadium and head coach.
Get team squadList a team's players with their shirt numbers and positions: the squad now, or in one season.
Get top scorersGet a season's top scorers, or the players with the most assists, yellow cards or red cards.
List latest transfersList the transfers most recently added or changed, newest first, with the player and both clubs.
List leaguesList the leagues your Sportmonks plan covers, each with its country and current season.
List live matchesList 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 datesList the matches between two dates, at most 100 days apart, for one team or league if chosen.
List matches on a dateList the matches played or scheduled on one day.
List player transfersList a player's moves between clubs, including loans.
List seasonsList a league's seasons, current and past, with their dates.
List team transfersList the players a team has signed or let go.
List teams in a seasonList the teams taking part in a season.
List transfers between datesList the transfers dated between two days, at most 31 days apart.
Search matchesFind matches by name, such as 'Celtic vs Rangers' or a single team's name.
Search playersFind players by name.
Search teamsFind teams by name, in any league your plan covers.

Get coach

Get one coach: name, date of birth and nationality.

Inputs

Coach IDcoach_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

Teamclub_idtextRequired
One of the two teams.
Other teamother_club_idtextRequired
The team they played against.
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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

Leagueleague_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

Seasonseason_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

Leagueleague_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 IDfixture_idtextRequired
The match's Sportmonks id, from a match list or an earlier step.
Also includedetailslist
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 IDplayer_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 IDreferee_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 IDvenue_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

Teamclub_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

Teamclub_idtextRequired
The team.
Seasonseason_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

Seasonseason_idtextRequired
The season.
Ranked bycategorytext
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.
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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

Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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

Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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 matchesscopetext
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.
Leagueleague_idtext
Only matches in this league.
Also includedetailslist
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

Fromstart_datedateRequired
The first day to include.
Untilend_datedateRequired
The last day to include, at most 100 days after the first.
Teamclub_idtext
Only this team's matches.
Leagueleague_idtext
Only matches in this league.
Orderordertext
Sort by date. Defaults to oldest first.One of: asc (Oldest first (default)), desc (Newest first).
Also includedetailslist
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).
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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

Datematch_datedateRequired
The day of the matches.
Leagueleague_idtext
Only matches in this league.
Also includedetailslist
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).
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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 IDplayer_idtextRequired
The player's Sportmonks id, from 'Get team squad', 'Search players' or an earlier step.
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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

Leagueleague_idtextRequired
The league.
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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

Teamclub_idtextRequired
The team.
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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

Seasonseason_idtextRequired
The season.
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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

Fromstart_datedateRequired
The first day to include.
Untilend_datedateRequired
The last day to include, at most 31 days after the first.
Orderordertext
Sort by date. Defaults to oldest first.One of: asc (Oldest first (default)), desc (Newest first).
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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

NamenametextRequired
All or part of the name to look for.
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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

NamenametextRequired
All or part of the name to look for.
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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

NamenametextRequired
All or part of the name to look for.
Pagepagenumber
Which page of results, starting at 1 (the default).At least 1.
Results per pageper_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"
    }
  ]
}

On this page