# Fantasy Premier League

> Follow Fantasy Premier League, the official Premier League fantasy game: players' prices, points, form and injury news, gameweek deadlines, fixtures and live points, any manager's team, transfers and history, and classic and head-to-head league tables. Start a workflow before each deadline or when a player's news changes. No account needed.

App · 18 actions. Web page: https://docs.lodol.com/docs/integrations/fantasy-premier-league

## Actions

### Get classic league standings

Get a classic league's table, 50 managers a page, with each manager's rank, their rank a gameweek ago, their gameweek points and total. Pick a month to see that month's table.

**Inputs**

- League ID (`league_id`, text, required): The classic league's id: the number after /leagues/ in the address of its standings page (pasting the address works too). 314 is Overall, every manager in the game.
- Month (`phase`, text): Rank managers by one month's points instead of the whole season. Leave empty for the whole season.
- Page (`page`, number): Which page of 50 to get. Defaults to 1, the top of the table. At least 1.

**Outputs**

- `count` (number): How many rows came back.
- `has_next` (true/false): True when there is another page after this one.
- `last_updated` (text): When FPL last updated the table, ISO 8601 in UTC.
- `league` (object): The league.
- `page` (number): The page returned.
- `standings` (list): The page's managers, by rank.

**Example output**

```json
{
  "count": 1,
  "has_next": true,
  "last_updated": "2026-10-21T05:59:23Z",
  "league": {
    "admin_manager_id": null,
    "closed": false,
    "created": "2026-07-23T11:37:00.733233Z",
    "id": 314,
    "name": "Overall",
    "start_gameweek": 1,
    "type": "General"
  },
  "page": 1,
  "standings": [
    {
      "gameweek_points": 75,
      "last_rank": 1,
      "manager_id": 895045,
      "manager_name": "Jo Bloggs",
      "rank": 1,
      "team_name": "Pressing Matters",
      "total_points": 620
    }
  ]
}
```

### Get dream team

Get a gameweek's dream team: the highest scoring eleven in a valid formation, with each player's points and the player of the week.

**Inputs**

- Gameweek (`gameweek`, text): Current, next, previous, or a gameweek's number. Leave empty for the current gameweek.

**Outputs**

- `count` (number): How many rows came back.
- `gameweek` (number): The gameweek.
- `players` (list): The eleven, goalkeeper first, then defence, midfield and attack.
- `top_player` (text): The player of the week.
- `top_player_id` (number): Id of the player of the week.
- `top_player_points` (number): Their points.
- `total_points` (number): The eleven's points added up.

**Example output**

```json
{
  "count": 1,
  "gameweek": 7,
  "players": [
    {
      "name": "Raya",
      "player_id": 1,
      "points": 9,
      "position": "Goalkeeper",
      "team": "Arsenal"
    }
  ],
  "top_player": "Neto",
  "top_player_id": 156,
  "top_player_points": 15,
  "total_points": 128
}
```

### Get gameweek

Get one gameweek, the current one unless you pick another: its deadline and the hours until it, whether it has finished and its points are final, and its scores, top player and most captained player.

**Inputs**

- Gameweek (`gameweek`, text): Current, next, previous, or a gameweek's number. Leave empty for the current gameweek.

**Outputs**

- `average_score` (number): Average points of all managers; empty before the deadline.
- `chips_played` (list): How often each chip was played.
- `deadline_time` (text): The transfer deadline, ISO 8601 in UTC.
- `finished` (true/false): True once every match and its bonus is in.
- `highest_score` (number): The highest manager score.
- `highest_scoring_manager_id` (number): The id of the manager who scored it.
- `hours_until_deadline` (number): Hours from now to the deadline; negative once past.
- `id` (number): The gameweek's number, 1 to 38.
- `is_current` (true/false): True for the gameweek being played now.
- `is_next` (true/false): True for the next gameweek, whose deadline is next.
- `is_previous` (true/false): True for the gameweek before the current one.
- `most_captained` (text): The most captained player.
- `most_selected` (text): The player most managers had.
- `most_transferred_in` (text): The player most transferred in.
- `most_vice_captained` (text): The most vice-captained player.
- `name` (text): E.g. 'Gameweek 8'.
- `points_confirmed` (true/false): True once FPL has checked the points and they are final.
- `top_player` (text): The highest scoring player.
- `top_player_id` (number): Id of the highest scoring player.
- `top_player_points` (number): That player's points.
- `total_managers` (number): How many managers are playing the game.
- `transfers_made` (number): Transfers made by all managers; empty before the deadline.

**Example output**

```json
{
  "average_score": 59,
  "chips_played": [
    {
      "chip": "Bench Boost",
      "played": 179094
    },
    {
      "chip": "Triple Captain",
      "played": 724286
    }
  ],
  "deadline_time": "2026-10-17T10:00:00Z",
  "finished": true,
  "highest_score": 122,
  "highest_scoring_manager_id": 504619,
  "hours_until_deadline": -92.1,
  "id": 7,
  "is_current": true,
  "is_next": false,
  "is_previous": false,
  "most_captained": "Haaland",
  "most_selected": "Haaland",
  "most_transferred_in": "Cherki",
  "most_vice_captained": "Jo\u00e3o Pedro",
  "name": "Gameweek 7",
  "points_confirmed": true,
  "top_player": "Neto",
  "top_player_id": 156,
  "top_player_points": 15,
  "total_managers": 11139212,
  "transfers_made": 12547022
}
```

### Get head-to-head league standings

Get a head-to-head league's table, 50 managers a page, with matches won, drawn and lost, FPL points scored and league points.

**Inputs**

- League ID (`league_id`, text, required): The head-to-head league's id: the number after /leagues/ in the address of its standings page. Pasting the address works too.
- Page (`page`, number): Which page of 50 to get. Defaults to 1, the top of the table. At least 1.

**Outputs**

- `count` (number): How many rows came back.
- `has_next` (true/false): True when there is another page after this one.
- `league` (object): The league.
- `page` (number): The page returned.
- `standings` (list): The page's managers, by rank.

**Example output**

```json
{
  "count": 1,
  "has_next": false,
  "league": {
    "admin_manager_id": 127255,
    "closed": true,
    "created": "2026-08-09T14:26:07.331009Z",
    "id": 735922,
    "name": "Football Hub H2H",
    "start_gameweek": 1,
    "type": "Invitational"
  },
  "page": 1,
  "standings": [
    {
      "drawn": 0,
      "last_rank": 1,
      "lost": 1,
      "manager_id": 4052692,
      "manager_name": "Alex Sample",
      "played": 7,
      "points": 18,
      "points_for": 591,
      "rank": 1,
      "team_name": "Wizards United",
      "won": 6
    }
  ]
}
```

### Get live points

Get every player's points in a gameweek as they stand, highest first, with minutes, goals, assists, bonus and how each point was earned. Filter by club or player.

**Inputs**

- Gameweek (`gameweek`, text): Current, next, previous, or a gameweek's number. Leave empty for the current gameweek.
- Team (`team`, text): Only players of this club. Leave empty for every club.
- Player (`player`, text): Only this player, whether or not they played. Leave empty for all.
- Only players who played (`played_only`, true/false): Leave out players who have not played a minute in the gameweek. Default: `true`.
- Number of results (`limit`, number): How many players to return, highest score first, 1 to 1000. Defaults to 50. From 1 to 1000.

**Outputs**

- `count` (number): How many rows came back.
- `gameweek` (number): The gameweek.
- `players` (list): The players, highest score first.
- `total_matching` (number): How many matched before the number of results was applied.

**Example output**

```json
{
  "count": 1,
  "gameweek": 7,
  "players": [
    {
      "assists": 0,
      "bonus": 3,
      "bps": 64,
      "breakdown": [
        {
          "fixture_id": 64,
          "points": 2,
          "stat": "Minutes played",
          "value": 90
        },
        {
          "fixture_id": 64,
          "points": 10,
          "stat": "Goals scored",
          "value": 2
        }
      ],
      "clean_sheets": 1,
      "defensive_contribution": 9,
      "expected_assists": 0.24,
      "expected_goals": 0.37,
      "goals_conceded": 0,
      "goals_scored": 2,
      "in_dream_team": true,
      "minutes": 90,
      "name": "Neto",
      "own_goals": 0,
      "penalties_missed": 0,
      "penalties_saved": 0,
      "player_id": 156,
      "points": 15,
      "position": "Midfielder",
      "red_cards": 0,
      "saves": 0,
      "team": "Chelsea",
      "yellow_cards": 1
    }
  ],
  "total_matching": 305
}
```

### Get manager

Get a manager's team: its name, overall points and rank, this gameweek's points, team value and money in the bank, and every league it is in with its rank there.

**Inputs**

- Manager ID (`manager_id`, text, required): The manager's id: the number after /entry/ in the address of their Points page on fantasy.premierleague.com. Pasting that address works too.

**Outputs**

- `bank` (number): Money in the bank at the last deadline, in £m.
- `classic_leagues` (list): The classic leagues they are in.
- `favourite_team` (text): The club they support, if they chose one.
- `gameweek` (number): The latest gameweek.
- `gameweek_points` (number): Points in that gameweek.
- `gameweek_rank` (number): Rank in that gameweek.
- `h2h_leagues` (list): The head-to-head leagues they are in.
- `id` (number): The manager's id.
- `joined_at` (text): When they entered this season, ISO 8601 in UTC.
- `manager_name` (text): The manager's name.
- `overall_points` (number): Points this season.
- `overall_rank` (number): Overall rank among every manager.
- `region` (text): The country or region they play from.
- `started_gameweek` (number): Their first gameweek this season.
- `team_name` (text): The team's name.
- `team_value` (number): Team value at the last deadline, in £m.
- `total_transfers` (number): Transfers made this season, chips aside.
- `url` (text): Their Points page on fantasy.premierleague.com.
- `years_active` (number): Earlier seasons they have played.

**Example output**

```json
{
  "bank": 1.1,
  "classic_leagues": [
    {
      "id": 314,
      "last_rank": 1,
      "managers": 11063246,
      "name": "Overall",
      "rank": 1,
      "type": "General"
    }
  ],
  "favourite_team": "Chelsea",
  "gameweek": 7,
  "gameweek_points": 75,
  "gameweek_rank": 1329646,
  "h2h_leagues": [],
  "id": 895045,
  "joined_at": "2026-07-24T12:20:37.045198Z",
  "manager_name": "Jo Bloggs",
  "overall_points": 620,
  "overall_rank": 1,
  "region": "India",
  "started_gameweek": 1,
  "team_name": "Pressing Matters",
  "team_value": 102.2,
  "total_transfers": 4,
  "url": "https://fantasy.premierleague.com/entry/895045/event/7",
  "years_active": 0
}
```

### Get manager history

Get a manager's season gameweek by gameweek (points, ranks, team value, transfers and points deducted for them, points left on the bench), the chips they have played and their past seasons.

**Inputs**

- Manager ID (`manager_id`, text, required): The manager's id: the number after /entry/ in the address of their Points page on fantasy.premierleague.com. Pasting that address works too.

**Outputs**

- `chips` (list): The chips played.
- `gameweeks` (list): Each gameweek played, oldest first.
- `manager_id` (number): The manager's id.
- `past_seasons` (list): Their earlier seasons.

**Example output**

```json
{
  "chips": [
    {
      "chip": "Bench Boost",
      "gameweek": 1,
      "played_at": "2026-08-17T19:20:39.205954Z"
    }
  ],
  "gameweeks": [
    {
      "bank": 0.7,
      "gameweek": 7,
      "gameweek_rank": 16062,
      "overall_rank": 2,
      "points": 97,
      "points_on_bench": 19,
      "team_value": 101.8,
      "total_points": 607,
      "transfer_cost": 0,
      "transfers": 2
    }
  ],
  "manager_id": 52087,
  "past_seasons": [
    {
      "rank": 608932,
      "season": "2015/16",
      "total_points": 2007
    }
  ]
}
```

### Get manager's team for a gameweek

Get the 15 players a manager picked for a gameweek, with captain and vice-captain, the bench, the chip played, automatic substitutions and each player's points. A team shows once the gameweek's deadline has passed.

**Inputs**

- Manager ID (`manager_id`, text, required): The manager's id: the number after /entry/ in the address of their Points page on fantasy.premierleague.com. Pasting that address works too.
- Gameweek (`gameweek`, text): Current, next, previous, or a gameweek's number. Leave empty for the current gameweek.

**Outputs**

- `active_chip` (text): The chip played that gameweek, if any.
- `automatic_subs` (list): Substitutes who came on for non-players.
- `bank` (number): Money in the bank, in £m.
- `gameweek` (number): The gameweek.
- `gameweek_rank` (number): Rank in the gameweek.
- `manager_id` (number): The manager's id.
- `overall_rank` (number): Overall rank after it.
- `picks` (list): The 15 players, starters first, then the bench.
- `points` (number): Points in the gameweek, after transfer hits.
- `points_on_bench` (number): Points left on the bench.
- `team_value` (number): Team value, in £m.
- `total_points` (number): Season total after it.
- `transfer_cost` (number): Points taken off for extra transfers.
- `transfers` (number): Transfers made for the gameweek.

**Example output**

```json
{
  "active_chip": null,
  "automatic_subs": [],
  "bank": 1.1,
  "gameweek": 7,
  "gameweek_rank": 1329652,
  "manager_id": 895045,
  "overall_rank": 1,
  "picks": [
    {
      "counted_points": 26,
      "is_captain": true,
      "is_vice_captain": false,
      "multiplier": 2,
      "name": "Haaland",
      "on_bench": false,
      "player_id": 411,
      "points": 13,
      "position": "Forward",
      "slot": 9,
      "team": "Man City"
    }
  ],
  "points": 75,
  "points_on_bench": 4,
  "team_value": 102.2,
  "total_points": 620,
  "transfer_cost": 0,
  "transfers": 2
}
```

### Get player

Get one player's details with every match they have played this season (points, minutes, goals, price at the time), their remaining fixtures with FPL's difficulty, and their past seasons.

**Inputs**

- Player (`player`, text, required): The player. Pick one, or give their id from an earlier step (List players shows ids).

**Outputs**

- `history` (list): Each match this season, oldest first.
- `past_seasons` (list): The player's earlier Premier League seasons.
- `player` (object): The player.
- `upcoming_fixtures` (list): The club's remaining fixtures.

**Example output**

```json
{
  "history": [
    {
      "assists": 1,
      "bonus": 2,
      "bps": 46,
      "clean_sheets": 1,
      "defensive_contribution": 4,
      "expected_assists": 0.21,
      "expected_goals": 1.47,
      "fixture_id": 7,
      "gameweek": 1,
      "goals_conceded": 0,
      "goals_scored": 1,
      "kickoff_time": "2026-08-23T13:00:00Z",
      "minutes": 77,
      "opponent": "Aston Villa",
      "opponent_id": 2,
      "opponent_score": 0,
      "points": 17,
      "price": 4.5,
      "red_cards": 0,
      "saves": 0,
      "selected_by": 151636,
      "team_score": 4,
      "transfers_balance": 0,
      "was_home": true,
      "yellow_cards": 0
    }
  ],
  "past_seasons": [
    {
      "assists": 3,
      "bonus": 9,
      "clean_sheets": 5,
      "end_price": 4.3,
      "expected_assists": 4.08,
      "expected_goals": 1.66,
      "goals_scored": 2,
      "minutes": 1404,
      "season": "2025/26",
      "start_price": 4.5,
      "total_points": 84
    }
  ],
  "player": {
    "assists": 3,
    "bonus": 8,
    "bps": 197,
    "chance_of_playing_next_round": null,
    "clean_sheets": 5,
    "defensive_contribution": 23,
    "expected_assists": 0.8,
    "expected_goal_involvements": 2.6,
    "expected_goals": 1.8,
    "expected_points_next": 10.5,
    "first_name": "Maxim",
    "form": 10.5,
    "gameweek_points": 6,
    "goals_conceded": 5,
    "goals_scored": 2,
    "ict_index": 46.2,
    "id": 115,
    "last_name": "De Cuyper",
    "minutes": 580,
    "name": "De Cuyper",
    "news": null,
    "news_added": null,
    "points_per_game": 8.4,
    "position": "Defender",
    "price": 5.3,
    "price_change_this_gameweek": 0.1,
    "price_change_this_season": 0.8,
    "red_cards": 0,
    "saves": 0,
    "selected_by_percent": 41.0,
    "starts": 7,
    "status": "Available",
    "team": "Brighton",
    "team_id": 5,
    "total_points": 59,
    "transfers_in_this_gameweek": 158863,
    "transfers_out_this_gameweek": 12306,
    "yellow_cards": 2
  },
  "upcoming_fixtures": [
    {
      "difficulty": 4,
      "fixture_id": 78,
      "gameweek": 8,
      "is_home": false,
      "kickoff_time": "2026-10-25T14:00:00Z",
      "opponent": "Liverpool",
      "opponent_id": 14
    }
  ]
}
```

### Get points status

Check whether the latest gameweek's bonus points are added and its points confirmed, match day by match day, and whether league tables have been updated.

**Inputs**: None.

**Outputs**

- `bonus_added` (true/false): True once every match day's bonus is added.
- `days` (list): Each match day.
- `gameweek` (number): The gameweek the status is for.
- `leagues` (text): League tables: Updated, Updating or Not started.
- `leagues_updated` (true/false): True once league tables include the gameweek.
- `points_confirmed` (true/false): True once every match day's points are confirmed.

**Example output**

```json
{
  "bonus_added": true,
  "days": [
    {
      "bonus_added": true,
      "date": "2026-10-17",
      "gameweek": 7,
      "points": "Confirmed"
    }
  ],
  "gameweek": 7,
  "leagues": "Updated",
  "leagues_updated": true,
  "points_confirmed": true
}
```

### List fixtures

List fixtures and results for a gameweek or a club, with kickoff times, scores, FPL's difficulty ratings, and who scored, assisted, was sent off and got bonus points.

**Inputs**

- Gameweek (`gameweek`, text): Only this gameweek's fixtures: current, next, previous or its number. Leave empty for the whole season.
- Team (`team`, text): Only this club's fixtures. Leave empty for every club.
- Which fixtures (`status`, text): All of them, only those not started yet, or only finished ones. One of: `all` (All fixtures), `upcoming` (Not started yet, soonest first), `finished` (Finished, most recent first). Default: `all`.
- Number of results (`limit`, number): How many fixtures to return, 1 to 1000. Defaults to 50. From 1 to 1000.

**Outputs**

- `count` (number): How many rows came back.
- `fixtures` (list): The fixtures, by kickoff time.
- `total_matching` (number): How many matched before the number of results was applied.

**Example output**

```json
{
  "count": 1,
  "fixtures": [
    {
      "assists": [
        {
          "player": "White",
          "player_id": 10,
          "team": "Arsenal",
          "value": 1
        }
      ],
      "away_difficulty": 5,
      "away_score": 1,
      "away_team": "Leeds",
      "away_team_id": 13,
      "bonus": [
        {
          "player": "Bruno G.",
          "player_id": 452,
          "team": "Arsenal",
          "value": 3
        }
      ],
      "finished": true,
      "gameweek": 6,
      "goals": [
        {
          "player": "Calafiori",
          "player_id": 8,
          "team": "Arsenal",
          "value": 1
        }
      ],
      "home_difficulty": 3,
      "home_score": 2,
      "home_team": "Arsenal",
      "home_team_id": 1,
      "id": 51,
      "kickoff_time": "2026-10-10T11:30:00Z",
      "minutes": 90,
      "own_goals": [],
      "red_cards": [],
      "started": true,
      "status": "Finished"
    }
  ],
  "total_matching": 10
}
```

### List gameweeks

List the season's 38 gameweeks with each one's deadline and hours to go and, once played, the average and highest scores, the top player, the most captained player and how often each chip was played.

**Inputs**

- Which gameweeks (`status`, text): All of them, the finished ones, or those whose deadline is to come. One of: `all` (All gameweeks), `finished`, `upcoming` (Deadline still to come). Default: `all`.

**Outputs**

- `count` (number): How many rows came back.
- `gameweeks` (list): The gameweeks, in order.

**Example output**

```json
{
  "count": 1,
  "gameweeks": [
    {
      "average_score": 59,
      "chips_played": [
        {
          "chip": "Bench Boost",
          "played": 179094
        },
        {
          "chip": "Triple Captain",
          "played": 724286
        }
      ],
      "deadline_time": "2026-10-17T10:00:00Z",
      "finished": true,
      "highest_score": 122,
      "highest_scoring_manager_id": 504619,
      "hours_until_deadline": -92.1,
      "id": 7,
      "is_current": true,
      "is_next": false,
      "is_previous": false,
      "most_captained": "Haaland",
      "most_selected": "Haaland",
      "most_transferred_in": "Cherki",
      "most_vice_captained": "Jo\u00e3o Pedro",
      "name": "Gameweek 7",
      "points_confirmed": true,
      "top_player": "Neto",
      "top_player_id": 156,
      "top_player_points": 15,
      "transfers_made": 12547022
    }
  ]
}
```

### List head-to-head matches

List a head-to-head league's matches, for one gameweek or the whole season, with both teams' points and the winner.

**Inputs**

- League ID (`league_id`, text, required): The head-to-head league's id: the number after /leagues/ in the address of its standings page. Pasting the address works too.
- Gameweek (`gameweek`, text): Only this gameweek's matches: current, next, previous or its number. Leave empty for the whole season.
- Page (`page`, number): Which page of 50 matches to get. Defaults to 1. At least 1.

**Outputs**

- `count` (number): How many rows came back.
- `has_next` (true/false): True when there is another page after this one.
- `league_id` (number): The league's id.
- `matches` (list): The page's matches.
- `page` (number): The page returned.

**Example output**

```json
{
  "count": 1,
  "has_next": false,
  "league_id": 735922,
  "matches": [
    {
      "gameweek": 7,
      "id": 10179643,
      "is_bye": false,
      "is_knockout": false,
      "manager_1_id": 704878,
      "manager_1_name": "Chris Example",
      "manager_2_id": 3878138,
      "manager_2_name": "Pat Sample",
      "team_1_name": "Pirates FC",
      "team_1_points": 57,
      "team_2_name": "Eleven Heroes",
      "team_2_points": 75,
      "winner": "Eleven Heroes"
    }
  ],
  "page": 1
}
```

### List manager's transfers

List the transfers a manager has made this season, newest first, with the players in and out and their prices. Narrow it to one gameweek.

**Inputs**

- Manager ID (`manager_id`, text, required): The manager's id: the number after /entry/ in the address of their Points page on fantasy.premierleague.com. Pasting that address works too.
- Gameweek (`gameweek`, text): Only transfers for this gameweek: current, next, previous or its number. Leave empty for the whole season.

**Outputs**

- `count` (number): How many rows came back.
- `manager_id` (number): The manager's id.
- `transfers` (list): The transfers, newest first.

**Example output**

```json
{
  "count": 1,
  "manager_id": 895045,
  "transfers": [
    {
      "gameweek": 7,
      "made_at": "2026-10-16T22:41:14.943928Z",
      "player_in": "Gonzalo",
      "player_in_id": 569,
      "player_in_price": 6.1,
      "player_out": "Wissa",
      "player_out_id": 464,
      "player_out_price": 6.2
    }
  ]
}
```

### List most valuable teams

List the most valuable teams in the game, counting money in the bank, with each manager's transfers this season.

**Inputs**: None.

**Outputs**

- `count` (number): How many rows came back.
- `teams` (list): The teams, most valuable first.

**Example output**

```json
{
  "count": 1,
  "teams": [
    {
      "manager_id": 750466,
      "manager_name": "Sam Example",
      "rank": 1,
      "team_name": "Value Hunters",
      "total_transfers": 24,
      "value_with_bank": 105.5
    }
  ]
}
```

### List players

List Fantasy Premier League players with their price, points, form, ownership and injury news. Filter by club, position, availability, price or name, and sort by points, form, price, ownership, transfers or price changes.

**Inputs**

- Team (`team`, text): Only players of this club. Leave empty for every club.
- Position (`position`, text): Only players in this position. Leave empty for all four. One of: `goalkeeper` (Goalkeepers), `defender` (Defenders), `midfielder` (Midfielders), `forward` (Forwards).
- Availability (`availability`, text): Only players with this status. Flagged means any player FPL marks with a warning. Leave empty for everyone. One of: `available`, `flagged` (Flagged: doubtful, injured, suspended or unavailable), `doubtful`, `injured`, `suspended`, `unavailable` (Unavailable: left the club, on loan or not registered).
- Lowest price (£m) (`min_price`, number): Only players costing at least this much, in £m, such as 5.5. From 0 to 30.
- Highest price (£m) (`max_price`, number): Only players costing at most this much, in £m, such as 7.5. From 0 to 30.
- Name contains (`search`, text): Only players whose name contains this, accents ignored.
- Sort by (`sort_by`, text): How to order the players, best first. Defaults to total points. One of: `total_points` (Total points), `form`, `gameweek_points` (Points this gameweek), `points_per_game` (Points per match), `expected_points_next` (Expected points next gameweek), `price_high` (Price, highest first), `price_low` (Price, lowest first), `selected_by` (Selected by most managers), `transfers_in` (Transfers in this gameweek), `transfers_out` (Transfers out this gameweek), and 5 more.
- Number of results (`limit`, number): How many players to return, 1 to 1000. Defaults to 20. From 1 to 1000.

**Outputs**

- `count` (number): How many rows came back.
- `players` (list): The players, best first.
- `total_matching` (number): How many matched before the number of results was applied.

**Example output**

```json
{
  "count": 1,
  "players": [
    {
      "assists": 3,
      "bonus": 8,
      "bps": 197,
      "chance_of_playing_next_round": null,
      "clean_sheets": 5,
      "defensive_contribution": 23,
      "expected_assists": 0.8,
      "expected_goal_involvements": 2.6,
      "expected_goals": 1.8,
      "expected_points_next": 10.5,
      "first_name": "Maxim",
      "form": 10.5,
      "gameweek_points": 6,
      "goals_conceded": 5,
      "goals_scored": 2,
      "ict_index": 46.2,
      "id": 115,
      "last_name": "De Cuyper",
      "minutes": 580,
      "name": "De Cuyper",
      "news": null,
      "news_added": null,
      "points_per_game": 8.4,
      "position": "Defender",
      "price": 5.3,
      "price_change_this_gameweek": 0.1,
      "price_change_this_season": 0.8,
      "red_cards": 0,
      "saves": 0,
      "selected_by_percent": 41.0,
      "starts": 7,
      "status": "Available",
      "team": "Brighton",
      "team_id": 5,
      "total_points": 59,
      "transfers_in_this_gameweek": 158863,
      "transfers_out_this_gameweek": 12306,
      "yellow_cards": 2
    }
  ],
  "total_matching": 668
}
```

### List set-piece takers

List each club's penalty, direct free kick and corner takers in FPL's order of preference, with FPL's own notes on them.

**Inputs**

- Team (`team`, text): Only this club. Leave empty for all 20.

**Outputs**

- `count` (number): How many rows came back.
- `last_updated` (text): When FPL last updated its notes, ISO 8601 in UTC.
- `teams` (list): Each club's takers.

**Example output**

```json
{
  "count": 1,
  "last_updated": "2026-10-17T22:04:28Z",
  "teams": [
    {
      "corners_and_indirect_free_kicks": [
        "Szoboszlai",
        "Mac Allister",
        "Wirtz",
        "Gakpo",
        "Tsimikas"
      ],
      "direct_free_kicks": [
        "Szoboszlai",
        "Wirtz",
        "Mac Allister"
      ],
      "notes": [
        "Check back for additional notes soon"
      ],
      "penalties": [
        "Szoboszlai",
        "Isak",
        "Gakpo",
        "Wirtz",
        "Mac Allister"
      ],
      "team": "Liverpool",
      "team_id": 14
    }
  ]
}
```

### List teams

List the season's 20 clubs in table order, each with its record worked out from the results (played, won, drawn, lost, goals, points), its last five results, FPL's strength ratings and its next fixture.

**Inputs**: None.

**Outputs**

- `count` (number): How many rows came back.
- `teams` (list): The clubs, in table order.

**Example output**

```json
{
  "count": 1,
  "teams": [
    {
      "drawn": 0,
      "form": "WWWWW",
      "goal_difference": 12,
      "goals_against": 7,
      "goals_for": 19,
      "id": 15,
      "lost": 0,
      "name": "Man City",
      "next_fixture": {
        "difficulty": 3,
        "gameweek": 8,
        "is_home": false,
        "kickoff_time": "2026-10-24T11:30:00Z",
        "opponent": "Aston Villa"
      },
      "played": 7,
      "points": 21,
      "position": 1,
      "short_name": "MCI",
      "strength_away": 5,
      "strength_home": 4,
      "won": 7
    }
  ]
}
```
