Skip to main content
GET
/
fantasy-league
/
{id}
Get fantasy league by id
curl --request GET \
  --url https://sandbox.api.fantasyfutbol.app/v1/fantasy-league/{id}
{
  "statusCode": 200,
  "message": "Fantasy league retrieved",
  "data": {
    "id": 9,
    "name": "kitboga",
    "is_active": true,
    "logo_url": "haha",
    "leagues": [
      {
        "id": 7,
        "name": "Premier League",
        "type": "football",
        "year": "2025",
        "season": "2025/2026",
        "country": "England",
        "end_date": "2026-05-24",
        "continent": "Europe",
        "is_active": true,
        "created_at": "2025-08-14T21:47:44.636477",
        "start_date": "2025-08-15T00:00:00Z"
      }
    ],
    "squad_config": {
      "id": "cd492594-52f8-4a24-8e2e-b83e92982403",
      "formation": "any",
      "league_id": 3,
      "created_at": "2024-06-20T08:27:08.562002",
      "updated_at": "2024-06-20T08:27:08.562002",
      "classification": "group",
      "required_bench": 4,
      "price_multiplier": 1000000,
      "required_players": 15,
      "required_forwards": 3,
      "required_defenders": 5,
      "maximum_price_entry": 15,
      "minimum_price_entry": 4,
      "price_fall_multiple": 0.1,
      "price_rise_multiple": 0.1,
      "default_squad_budget": 100,
      "max_players_per_team": 3,
      "max_transfers_per_gw": 1,
      "price_entry_multiple": 0.5,
      "required_goalkeepers": 2,
      "required_midfielders": 5,
      "required_starting_squad": 11,
      "default_starting_forwards": 2,
      "minimum_starting_forwards": 1,
      "default_starting_defenders": 4,
      "minimum_starting_defenders": 3,
      "default_starting_goalkeepers": 1,
      "default_starting_midfielders": 4,
      "minimum_starting_goalkeepers": 1,
      "minimum_starting_midfielders": 3
    },
    "points_config": {
      "id": "302e0adb-74dc-4bfd-a8f2-b1d315588e45",
      "league_id": 7,
      "created_at": "2025-08-14T21:52:36.274558",
      "updated_at": "2025-08-14T21:52:36.274558",
      "sub_in_points": 1,
      "bencher_points": 0,
      "starter_points": 1,
      "sub_out_points": 0,
      "goal_save_ratio": 3,
      "own_goal_points": -2,
      "red_card_points": -2,
      "goal_save_points": 1,
      "yellow_card_points": -1,
      "forward_goal_points": 4,
      "penalty_miss_points": -2,
      "penalty_save_points": 7,
      "defender_goal_points": 5,
      "forward_assist_points": 3,
      "minutes_played_points": 1,
      "defender_assist_points": 4,
      "forward_concede_points": 0,
      "goalkeeper_goal_points": 8,
      "midfielder_goal_points": 4,
      "defender_concede_points": -1,
      "goalkeeper_assist_points": 5,
      "midfielder_assist_points": 3,
      "goalkeeper_concede_points": -1,
      "midfielder_concede_points": 0,
      "forward_clean_sheet_points": 0,
      "defender_clean_sheet_points": 4,
      "forward_goal_concede_points": 0,
      "defender_goal_concede_points": -0.5,
      "goalkeeper_clean_sheet_points": 5,
      "midfielder_clean_sheet_points": 1,
      "goalkeeper_goal_concede_points": -0.5,
      "midfielder_goal_concede_points": 0,
      "clean_sheet_eligibility_minutes": 60,
      "time_onfield_eligibility_minutes": 60
    },
    "current_game_week": {
      "id": "99b01026-edfc-44c3-8f3b-484edc6f22c0",
      "week": "GW38",
      "start_date": "2026-05-24T17:00:00+00:00",
      "end_date": "2026-05-24T17:00:00+00:00"
    },
    "next_game_week": {
      "id": "50fb02b4-22dc-4b0e-bbee-55c94030aaf1",
      "week": "GW12",
      "start_date": "2025-11-22T11:30:00+00:00",
      "end_date": "2025-11-24T23:00:00+00:00"
    }
  }
}

Headers

x-api-key
string

Path Parameters

id
integer<int64>
required

ID of the fantasy league to retrieve

Response

200 - application/json

Fantasy league retrieved

statusCode
integer
required
Example:

200

message
string
required
Example:

"Fantasy league retrieved"

data
object
required