GET /v4/leagues/recommended

Returns a list of recommended leagues for the authenticated user. Each league entry includes competition details, the user's custom league name, member count, and the list of members participating in that league.

Authentication

This endpoint requires a valid Bearer token passed via the {{token}} variable:

Authorization: Bearer {{token}}

Response Structure

The response contains a top-level object with an it array, where each item represents a recommended league.

Top-level fields

Field	Type	Description
`it`	array	List of recommended league objects

League object fields

Field	Type	Description
`i`	string	Unique league ID
`cpn`	string	Competition name (e.g. "Bundesliga", "La Liga")
`lnm`	string	User-defined league name
`mgc`	number	Member/game count — number of members in the league
`mid`	array of strings	List of member user IDs in the league
`m`	array of objects	Array of member objects

Member object (`m`) fields

Field	Type	Description
`ui`	string	User ID of the member
`uim`	string	(Optional) URL path to the user's profile image

Example Response

{
  "it": [
    {
      "i": "10000625",
      "cpn": "Bundesliga",
      "lnm": "Uncs",
      "mgc": 1,
      "mid": ["3888936"],
      "m": [{ "ui": "3888936" }]
    },
    {
      "i": "9957029",
      "cpn": "2. Bundesliga",
      "lnm": "Liga 2.",
      "mgc": 9,
      "mid": ["2137767", "3258302", "3395920", "3501692"],
      "m": [
        { "ui": "2137767" },
        { "ui": "3258302" },
        { "ui": "3395920" },
        { "ui": "3501692" }
      ]
    }
  ]
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

{ "it": [ { "i": "10000625", "cpn": "Bundesliga", "lnm": "Uncs", "mgc": 1, "mid": [ "3888936" ], "m": [ { "ui": "3888936" } ] }, { "i": "9957029", "cpn": "2. Bundesliga", "lnm": "Liga 2.", "mgc": 9, "mid": [ "2137767", "3258302", "3395920", "3501692" ], "m": [ { "ui": "2137767", "uim": "user/8a61c432fbac43178c45f78daf7a3ac2.jpe" }, { "ui": "3258302", "uim": "user/3a01f0ffc9d9442ab1dfc6852dc2c3df.jpe" }, { "ui": "3395920" }, { "ui": "3501692" } ] }, { "i": "10000431", "cpn": "La Liga", "lnm": "meine Liga", "mgc": 1, "mid": [ "3600515" ], "m": [ { "ui": "3600515" } ] }, { "i": "9957640", "cpn": "GP Frauen-Bundesliga", "lnm": "woman-League", "mgc": 9, "mid": [ "1686524", "1788726", "3397037", "3749221" ], "m": [ { "ui": "1686524", "uim": "user/0e96ab2e39f34346a2075c2187a314e6.png" }, { "ui": "1788726", "uim": "user/5e64bd731154441bb3407b8b08a7f064.jpe" }, { "ui": "3397037" }, { "ui": "3749221" } ] }, { "i": "9670727", "cpn": "Baller League UK", "lnm": "Bebe", "mgc": 18, "mid": [ "3738932", "3834694", "3860333", "3865371" ], "m": [ { "ui": "3738932" }, { "ui": "3834694" }, { "ui": "3860333" }, { "ui": "3865371" } ] }, { "i": "9998879", "cpn": "MLS", "lnm": "Fc MMH", "mgc": 1, "mid": [ "3890526" ], "m": [ { "ui": "3890526" } ] } ] }

GET /v4/leagues/recommended