# Sportmonks

> 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.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/sportmonks

## Actions

### Get coach

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

**Inputs**

- Coach ID (`coach_id`, text, required): The coach's Sportmonks id, such as a team's 'coach_id' from 'Get team'.

**Outputs**

- `coach` (object): The coach

**Example output**

```json
{
  "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_id`, text, required): One of the two teams.
- Other team (`other_club_id`, text, required): The team they played against.
- Page (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `fixtures` (list): The matches
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number

**Example output**

```json
{
  "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_id`, text, required): The league.

**Outputs**

- `league` (object): The league

**Example output**

```json
{
  "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_id`, text, required): The season.

**Outputs**

- `count` (number): How many rows
- `standings` (list): The table's rows, in order of position

**Example output**

```json
{
  "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_id`, text, required): The league.

**Outputs**

- `count` (number): How many rows
- `standings` (list): The table's rows, in order of position

**Example output**

```json
{
  "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_id`, text, required): The match's Sportmonks id, from a match list or an earlier step.
- Also include (`details`, list): 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**

- `fixture` (object): The match

**Example output**

```json
{
  "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_id`, text, required): The player's Sportmonks id, from 'Get team squad', 'Search players' or an earlier step.

**Outputs**

- `player` (object): The player

**Example output**

```json
{
  "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_id`, text, required): The referee's Sportmonks id, such as a match's 'referee_id' from 'Get match' with Referees included.

**Outputs**

- `referee` (object): The referee

**Example output**

```json
{
  "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_id`, text, required): The stadium's Sportmonks id, such as a team's or a match's 'venue_id'.

**Outputs**

- `venue` (object): The stadium

**Example output**

```json
{
  "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_id`, text, required): The team.

**Outputs**

- `team` (object): The team

**Example output**

```json
{
  "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_id`, text, required): The team.
- Season (`season_id`, text): A season, for that season's squad.

**Outputs**

- `count` (number): How many
- `squad` (list): The players

**Example output**

```json
{
  "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_id`, text, required): The season.
- Ranked by (`category`, text): 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 (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number
- `topscorers` (list): The ranked players

**Example output**

```json
{
  "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 (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number
- `transfers` (list): The transfers

**Example output**

```json
{
  "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 (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is a next page
- `leagues` (list): The leagues
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number

**Example output**

```json
{
  "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 (`scope`, text): 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_id`, text): Only matches in this league.
- Also include (`details`, list): 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**

- `count` (number): How many
- `fixtures` (list): The live matches

**Example output**

```json
{
  "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_date`, date, required): The first day to include.
- Until (`end_date`, date, required): The last day to include, at most 100 days after the first.
- Team (`club_id`, text): Only this team's matches.
- League (`league_id`, text): Only matches in this league.
- Order (`order`, text): Sort by date. Defaults to oldest first. One of: `asc` (Oldest first (default)), `desc` (Newest first).
- Also include (`details`, list): 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 (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `fixtures` (list): The matches
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number

**Example output**

```json
{
  "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_date`, date, required): The day of the matches.
- League (`league_id`, text): Only matches in this league.
- Also include (`details`, list): 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 (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `fixtures` (list): The matches
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number

**Example output**

```json
{
  "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_id`, text, required): The player's Sportmonks id, from 'Get team squad', 'Search players' or an earlier step.
- Page (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number
- `transfers` (list): The transfers

**Example output**

```json
{
  "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_id`, text, required): The league.
- Page (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number
- `seasons` (list): The seasons

**Example output**

```json
{
  "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_id`, text, required): The team.
- Page (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number
- `transfers` (list): The transfers

**Example output**

```json
{
  "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_id`, text, required): The season.
- Page (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number
- `teams` (list): The teams

**Example output**

```json
{
  "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_date`, date, required): The first day to include.
- Until (`end_date`, date, required): The last day to include, at most 31 days after the first.
- Order (`order`, text): Sort by date. Defaults to oldest first. One of: `asc` (Oldest first (default)), `desc` (Newest first).
- Page (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number
- `transfers` (list): The transfers

**Example output**

```json
{
  "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 (`name`, text, required): All or part of the name to look for.
- Page (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `fixtures` (list): The matches
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number

**Example output**

```json
{
  "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 (`name`, text, required): All or part of the name to look for.
- Page (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number
- `players` (list): The players

**Example output**

```json
{
  "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 (`name`, text, required): All or part of the name to look for.
- Page (`page`, number): Which page of results, starting at 1 (the default). At least 1.
- Results per page (`per_page`, number): How many to return, 1 to 50. Sportmonks' default is 25. From 1 to 50.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is a next page
- `next_page` (number): The next page's number, empty on the last page
- `page` (number): This page's number
- `teams` (list): The teams

**Example output**

```json
{
  "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"
    }
  ]
}
```
