1. overview
Kickbase API v4
  • v4
    • leagues
      • {leagueId}
        • market
          • {playerId}
            • offers
              • {offerId}
                • accept
                  • POST /v4/leagues/{leagueId}/market/{playerId}/offers/{offerId}/accept
                  • Accept Manager Offer
                • decline
                  • POST /v4/leagues/{leagueId}/market/{playerId}/offers/{offerId}/decline
                  • Decline Manager Offer
                • DELETE /v4/leagues/{leagueId}/market/{playerId}/offers/{offerId}
              • POST /v4/leagues/{leagueId}/market/{playerId}/offers
            • sell
              • POST /v4/leagues/{leagueId}/market/{playerId}/sell
              • Accept Kickbase Offer
            • DELETE /v4/leagues/{leagueId}/market/{playerId}
          • GET /v4/leagues/{leagueId}/market
          • POST /v4/leagues/{leagueId}/market
        • scoutedplayers
          • {playerId}
            • DELETE /v4/leagues/:leagueId/scoutedplayers/:playerId
            • POST /v4/leagues/{leagueId}/scoutedplayers/{playerId}
          • DELETE /v4/leagues/{leagueId}/scoutedplayers
          • GET /v4/leagues/{leagueId}/scoutedplayers
        • users
          • {userId}
            • teamcenter
              • GET /v4/leagues/{leagueId}/users/{userId}/teamcenter
            • unlock
              • POST /v4/leagues/{leagueId}/users/{userId}/unlock
            • DELETE /v4/leagues/{leagueId}/users/{userId}
        • activitiesFeed
          • {activityId}
            • comments
              • GET /v4/leagues/{leagueId}/activitiesFeed/{activityId}/comments
              • POST /v4/leagues/{leagueId}/activitiesFeed/{activityId}/comments
            • GET /v4/leagues/{leagueId}/activitiesFeed/{activityId}
          • GET /v4/leagues/{leagueId}/activitiesFeed
        • battles
          • {type}
            • users
              • GET /v4/leagues/{leagueId}/battles/{type}/users
        • lineup
          • overview
            • GET /v4/leagues/{leagueId}/lineup/overview
              GET
          • selection
            • GET /v4/leagues/{leagueId}/lineup/selection
          • teams
            • GET /v4/leagues/{leagueId}/lineup/teams
          • clear
            • POST /v4/leagues/{leagueId}/lineup/clear
          • fill
            • POST /v4/leagues/{leagueId}/lineup/fill
          • GET /v4/leagues/{leagueId}/lineup
            GET
          • POST /v4/leagues/{leagueId}/lineup
            POST
        • managers
          • {managerId}
            • dashboard
              • GET /v4/leagues/{leagueId}/managers/{managerId}/dashboard
            • performance
              • GET /v4/leagues/{leagueId}/managers/{managerId}/performance
            • squad
              • GET /v4/leagues/{leagueId}/managers/{managerId}/squad
            • transfer
              • GET /v4/leagues/{leagueId}/managers/{managerId}/transfer
        • me
          • budget
            • GET /v4/leagues/{leagueId}/me/budget
          • GET /v4/leagues/{leagueId}/me
        • overview
          • GET /v4/leagues/{leagueId}/overview
        • players
          • {playerId}
            • marketValue
              • {timeframe}
                • GET /v4/leagues/{leagueId}/players/{playerId}/marketValue/{timeframe}
            • performance
              • GET /v4/leagues/{leagueId}/players/{playerId}/performance
            • transferHistory
              • GET /v4/leagues/{leagueId}/players/{playerId}/transferHistory
            • transfers
              • GET /v4/leagues/{leagueId}/players/{playerId}/transfers
            • marketvalue
              • {timeframe}
                • Market Value
            • GET /v4/leagues/{leagueId}/players/{playerId}
        • ranking
          • GET /v4/leagues/{leagueId}/ranking
        • settings
          • managers
            • GET /v4/leagues/{leagueId}/settings/managers
          • GET /v4/leagues/{leagueId}/settings
          • POST /v4/leagues/{leagueId}/settings
        • squad
          • GET /v4/leagues/{leagueId}/squad
        • teamcenter
          • myeleven
            • GET /v4/leagues/{leagueId}/teamcenter/myeleven
        • teams
          • {teamId}
            • teamprofile
              • Profile
        • user
          • achievements
            • {type}
              • GET /v4/leagues/{leagueId}/user/achievements/{type}
            • GET /v4/leagues/{leagueId}/user/achievements
        • image
          • POST /v4/leagues/{leagueId}/image
        • join
          • {code}
            • POST /v4/leagues/{leagueId}/join/{code}
          • POST /v4/leagues/{leagueId}/join
        • reset
          • POST /v4/leagues/{leagueId}/reset
        • resetteams
          • POST /v4/leagues/{leagueId}/resetteams
        • setteamseen
          • POST /v4/leagues/{leagueId}/setteamseen
      • list
        • GET /v4/leagues/list
      • recommended
        • GET /v4/leagues/recommended
      • selection
        • GET /v4/leagues/selection
      • GET /v4/leagues
        GET
    • competitions
      • {competitionId}
        • matchdays
          • GET /v4/competitions/{competitionId}/matchdays
        • playercenter
          • {playerId}
            • GET /v4/competitions/{competitionId}/playercenter/{playerId}
        • players
          • search
            • GET /v4/competitions/{competitionId}/players/search
          • {playerId}
            • marketValue
              • {timeframe}
                • GET /v4/competitions/{competitionId}/players/{playerId}/marketValue/{timeframe}
            • performance
              • GET /v4/competitions/{competitionId}/players/{playerId}/performance
            • marketvalue
              • {timeframe}
                • Market Value
            • GET /v4/competitions/{competitionId}/players/{playerId}
          • GET /v4/competitions/{competitionId}/players
        • ranking
          • GET /v4/competitions/{competitionId}/ranking
        • table
          • GET /v4/competitions/{competitionId}/table
        • teams
          • {teamId}
            • teamcenter
              • GET /v4/competitions/{competitionId}/teams/{teamId}/teamcenter
            • teamprofile
              • GET /v4/competitions/{competitionId}/teams/{teamId}/teamprofile
      • GET /v4/competitions
    • matches
      • {matchId}
        • betlink
          • GET /v4/matches/{matchId}/betlink
        • details
          • GET /v4/matches/{matchId}/details
    • live
      • eventtypes
        • GET /v4/live/eventtypes
    • user
      • targets
        • {connection}
          • DELETE /v4/user/targets/{connection}
        • POST /v4/user/targets
      • me
        • GET /v4/user/me
      • settings
        • image
          • POST /v4/user/settings/image
        • GET /v4/user/settings
        • PUT /v4/user/settings
      • forgotpassword
        • POST /v4/user/forgotpassword
      • login
        • POST /v4/user/login
      • password
        • POST /v4/user/password
      • refreshtokens
        • POST /v4/user/refreshtokens
      • register
        • POST /v4/user/register
      • DELETE /v4/user
    • challenges
      • favorites
        • {favoriteUserId}
          • DELETE /v4/challenges/favorites/{favoriteUserId}
        • POST /v4/challenges/favorites
      • socialhub
        • {followedUserId}
          • DELETE /v4/challenges/socialhub/{followedUserId}
        • invitation
          • GET /v4/challenges/socialhub/invitation
        • search
          • GET /v4/challenges/socialhub/search
        • GET /v4/challenges/socialhub
        • POST /v4/challenges/socialhub
      • archive
        • GET /v4/challenges/archive
      • lobby
        • archive
          • GET /v4/challenges/lobby/archive
        • divisionLadder
          • GET /v4/challenges/lobby/divisionLadder
        • explore
          • {challengeId}
            • GET /v4/challenges/lobby/explore/{challengeId}
          • GET /v4/challenges/lobby/explore
        • overview
          • live
            • GET /v4/challenges/lobby/overview/live
          • GET /v4/challenges/lobby/overview
        • profile
          • GET /v4/challenges/lobby/profile
        • skillPoints
          • summary
            • GET /v4/challenges/lobby/skillPoints/summary
          • collect
            • POST /v4/challenges/lobby/skillPoints/collect
      • overview
        • GET /v4/challenges/overview
      • recommended
        • GET /v4/challenges/recommended
      • selection
        • GET /v4/challenges/selection
      • {challengeId}
        • favorites
          • search
            • GET /v4/challenges/{challengeId}/favorites/search
          • GET /v4/challenges/{challengeId}/favorites
        • lineup
          • livepitch
            • GET /v4/challenges/{challengeId}/lineup/livepitch
          • overview
            • GET /v4/challenges/{challengeId}/lineup/overview
          • selection
            • GET /v4/challenges/{challengeId}/lineup/selection
          • teams
            • GET /v4/challenges/{challengeId}/lineup/teams
          • clear
            • POST /v4/challenges/{challengeId}/lineup/clear
          • fill
            • POST /v4/challenges/{challengeId}/lineup/fill
        • perfectlineup
          • GET /v4/challenges/{challengeId}/perfectlineup
        • performance
          • GET /v4/challenges/{challengeId}/performance
        • profile
          • GET /v4/challenges/{challengeId}/profile
        • ranking
          • GET /v4/challenges/{challengeId}/ranking
        • table
          • {userId}
            • GET /v4/challenges/{challengeId}/table/{userId}
          • GET /v4/challenges/{challengeId}/table
        • top10
          • GET /v4/challenges/{challengeId}/top10
        • join
          • POST /v4/challenges/{challengeId}/join
      • join
        • POST /v4/challenges/join
    • bonus
      • collect
        • GET /v4/bonus/collect
    • chat
      • leagueselection
        • {leagueId}
          • users
            • GET /v4/chat/leagueselection/{leagueId}/users
        • GET /v4/chat/leagueselection
      • refreshtoken
        • GET /v4/chat/refreshtoken
    • base
      • items
        • {itemId}
          • click
            • POST /v4/base/items/{itemId}/click
          • GET /v4/base/items/{itemId}
      • news
        • permanent
          • {competitionId}
            • GET /v4/base/news/permanent/{competitionId}
        • {competitionId}
          • GET /v4/base/news/{competitionId}
      • predictions
        • teams
          • {competitionId}
            • GET /v4/base/predictions/teams/{competitionId}
      • stage
        • GET /v4/base/stage
      • overview
        • Base Overview
    • config
      • onboarding
        • GET /v4/config/onboarding
      • version
        • GET /v4/config/version
      • GET /v4/config
    • invitations
      • {code}
        • validate
          • GET /v4/invitations/{code}/validate
      • {leagueId}
        • code
          • GET /v4/invitations/{leagueId}/code
    • onboarding
      • challenge
        • {challengeId}
          • lineup
            • fill
              • POST /v4/onboarding/challenge/{challengeId}/lineup/fill
        • GET /v4/onboarding/challenge
      • freetrial
        • GET /v4/onboarding/freetrial
      • gameMode
        • recommendation
          • GET /v4/onboarding/gameMode/recommendation
      • league
        • invitation
          • {code}
            • validate
              • GET /v4/onboarding/league/invitation/{code}/validate
      • rushasset
        • GET /v4/onboarding/rushasset
      • training
        • challenge
          • GET /v4/onboarding/training/challenge
    • products
      • purchase
        • POST /v4/products/purchase
      • GET /v4/products
    • promotion
      • GET /v4/promotion
    • refiner
      • identify
        • GET /v4/refiner/identify
    • settings
      • subscriptionStatus
        • GET /v4/settings/subscriptionStatus
    • support
      • contactinfo
        • GET /v4/support/contactinfo
    • usertracking
      • firsttransfer
        • GET /v4/usertracking/firsttransfer
      • firsttransferseen
        • POST /v4/usertracking/firsttransferseen
  1. overview

GET /v4/leagues/{leagueId}/lineup/overview

GET
https://api.kickbase.com/v4/leagues/{leagueId}/lineup/overview
Retrieves the current lineup overview for a specific Kickbase league. This includes the manager's selected players, their positions, market values, average points, and status flags, as well as the active formation and upcoming matchday information.

Path Variable#

VariableDescription
leagueIdRequired. The unique identifier of the league whose lineup overview should be fetched. Corresponds to the {{leagueId}} environment variable.

Authentication#

This request inherits Bearer token authentication from the collection. Ensure {{token}} is set in your active environment.

Response (200 OK)#

Returns a JSON object with the following top-level fields:
FieldTypeDescription
mdlnstringCurrent matchday number
lisstring (ISO 8601)Timestamp of the next lineup lock (when the lineup can no longer be changed)
bnumberBudget/balance indicator
tstringActive formation (e.g. "4-2-4")
lpcnumberTotal number of players in the lineup
clpcnumberCount of players with a confirmed lineup status
uastringRelative path to the manager's avatar image
cptebooleanWhether the captain has been set
lparrayList of lineup players (see below)
ltarrayList of transfer-related entries (may be empty)

Lineup Player Object (lp)#

Each entry in the lp array represents a player in the lineup:
FieldTypeDescription
pistringPlayer ID
nstringPlayer name
posnumberPosition (1 = Goalkeeper, 2 = Defender, 3 = Midfielder, 4 = Forward)
lonumberLineup order/slot index
stnumberPlayer status flag (e.g. 0 = available, 4 = injured, 128 = unknown/no data)
lstnumberLast-season status flag
mdstnumberMatchday status (e.g. 0 = playing, 8 = not playing this matchday)
tidstringTeam ID of the player's current club
apnumberAverage points scored by the player
mvnumberCurrent market value of the player (in euros)
t1stringHome team ID for the player's next fixture
t2stringAway team ID for the player's next fixture
pimstringRelative path to the player's image
t1imstringRelative path to the home team's logo
t2imstringRelative path to the away team's logo
ictpbooleanWhether the player is the captain

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Header Params

Responses

🟢200
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://api.kickbase.com/v4/leagues//lineup/overview' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "mdln": "24",
    "lis": "2026-02-27T19:30:00Z",
    "b": 0,
    "lp": [
        {
            "pi": "755",
            "n": "Müller",
            "st": 128,
            "lst": 0,
            "mdst": 8,
            "pos": 1,
            "lo": 0,
            "tid": "8",
            "ap": 0,
            "mv": 0,
            "pim": "content/file/aa54ac360d6c43b09258ce28b924ba83.png",
            "ictp": false
        },
        {
            "pi": "3543",
            "n": "Brown",
            "st": 0,
            "lst": 1,
            "mdst": 0,
            "pos": 2,
            "lo": 1,
            "tid": "4",
            "ap": 82,
            "mv": 19200000,
            "t1": "4",
            "t2": "5",
            "pim": "content/file/3b8eae1b9d6d4e8d961bfd3f152db402.png",
            "t1im": "content/file/422de82bee3b47eb898699d6d27095ba.svg",
            "t2im": "content/file/6c1a9f14b668493283f966834891aa70.svg",
            "ictp": false
        },
        {
            "pi": "6173",
            "n": "Grimaldo",
            "st": 0,
            "lst": 1,
            "mdst": 0,
            "pos": 2,
            "lo": 2,
            "tid": "7",
            "ap": 155,
            "mv": 42800000,
            "t1": "7",
            "t2": "18",
            "pim": "content/file/353820bceb58462590ea1a470cde9cc6.png",
            "t1im": "content/file/e06a055a6eaf4fd7bebfadb35037f957.svg",
            "t2im": "content/file/d4ac9675b44944039d463837f888cb1c.svg",
            "ictp": false
        },
        {
            "pi": "2651",
            "n": "Pedersen",
            "st": 0,
            "lst": 1,
            "mdst": 0,
            "pos": 2,
            "lo": 4,
            "tid": "13",
            "ap": 12,
            "mv": 500000,
            "t1": "13",
            "t2": "28",
            "pim": "content/file/b93977fb3dee4e75af09d67896a1666b.png",
            "t1im": "content/file/8d68c946b9774505b8292adfa910d0a0.svg",
            "t2im": "content/file/dca70c4089fd4623932b245c0e81eaba.svg",
            "ictp": false
        },
        {
            "pi": "8329",
            "n": "Olise",
            "st": 0,
            "lst": 1,
            "mdst": 0,
            "pos": 3,
            "lo": 5,
            "tid": "2",
            "ap": 241,
            "mv": 60400000,
            "t1": "3",
            "t2": "2",
            "pim": "content/file/48622993193e45f09d696908d75ed523.png",
            "t1im": "content/file/dc3d63ae79bf4282a4107bafcd572b99.svg",
            "t2im": "content/file/ff70df040a9f4179a7b45219225a2273.svg",
            "ictp": false
        },
        {
            "pi": "3481",
            "n": "Stage",
            "st": 0,
            "lst": 1,
            "mdst": 0,
            "pos": 3,
            "lo": 6,
            "tid": "10",
            "ap": 93,
            "mv": 23000000,
            "t1": "10",
            "t2": "50",
            "pim": "content/file/1a88a39549924d048294f618079e8437.png",
            "t1im": "content/file/a7e609e72fb04c6d8c96e8ed82f0315d.svg",
            "t2im": "content/file/f387dd39aafb47d0b4863381fc4a521c.svg",
            "ictp": false
        },
        {
            "pi": "6177",
            "n": "Šeško",
            "st": 128,
            "lst": 0,
            "mdst": 8,
            "pos": 4,
            "lo": 7,
            "tid": "43",
            "ap": 0,
            "mv": 0,
            "t1": "6",
            "t2": "43",
            "pim": "content/file/fe5ccc7927254a46ab71aeed829805e4.png",
            "t1im": "content/file/c9b7d8772f324f9badeb285af4c5810a.svg",
            "t2im": "content/file/29ceb88867954b548ca9e27d39d050c2.svg",
            "ictp": false
        },
        {
            "pi": "849",
            "n": "Kleindienst",
            "st": 4,
            "lst": 1,
            "mdst": 0,
            "pos": 4,
            "lo": 8,
            "tid": "15",
            "ap": 18,
            "mv": 4300000,
            "t1": "15",
            "t2": "40",
            "pim": "content/file/d4b8e5025d3043b3ad48c1f6ac91830d.png",
            "t1im": "content/file/7178ef92ad0747a5ad1a05d0783f5088.svg",
            "t2im": "content/file/8f4c7c08ee9b4dca85c28260fc5917bd.svg",
            "ictp": false
        },
        {
            "pi": "7226",
            "n": "Kane",
            "st": 0,
            "lst": 1,
            "mdst": 0,
            "pos": 4,
            "lo": 9,
            "tid": "2",
            "ap": 230,
            "mv": 65500000,
            "t1": "3",
            "t2": "2",
            "pim": "content/file/48622993193e45f09d696908d75ed523.png",
            "t1im": "content/file/dc3d63ae79bf4282a4107bafcd572b99.svg",
            "t2im": "content/file/ff70df040a9f4179a7b45219225a2273.svg",
            "ictp": false
        }
    ],
    "lt": [],
    "t": "4-2-4",
    "lpc": 9,
    "clpc": 0,
    "ua": "content/file/e67d5e728a3d44a7ba28046994e18d78.png",
    "cpte": false
}
Previous
GET /v4/leagues/{leagueId}/battles/{type}/users
Next
GET /v4/leagues/{leagueId}/lineup/selection
Built with