1. selection
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
          • 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
          • POST /v4/leagues/{leagueId}/lineup
        • 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
    • 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
              GET
          • 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. selection

GET /v4/challenges/{challengeId}/lineup/selection

GET
https://api.kickbase.com/v4/challenges/{challengeId}/lineup/selection

Player List for Lineup Selection#

Retrieves a list of available players for lineup selection within a specific challenge. Use this endpoint to populate player picker UIs, apply filters by position or search query, and support substitution workflows by specifying a player to be replaced.

Path Variables#

VariableDescription
challengeIdThe unique identifier of the challenge for which the lineup selection is being made.

Query Parameters#

ParameterDescription
positionFilter players by their field position (e.g. goalkeeper, defender, midfielder, forward).
startThe offset index for pagination — defines the starting point of the result set.
queryA search string to filter players by name or other searchable attributes.
sortingDefines the sort order of the returned player list (e.g. by market value, points, or name).
playerToBeReplacedByIdThe ID of the player currently in the lineup who is being replaced. Used to contextualise the selection.
maxThe maximum number of players to return in the response (page size).

Headers#

HeaderValueDescription
Acceptapplication/jsonSpecifies that the response should be returned in JSON format.

Notes#

All query parameters are optional — omitting them returns an unfiltered, default-sorted list.
Use start and max together to implement pagination across large player pools.
When performing a substitution, pass playerToBeReplacedById to allow the API to apply eligibility or positional constraints relevant to the replacement context.

Request

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

Query Params

Header Params

Responses

🟢200
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://api.kickbase.com/v4/challenges//lineup/selection?position=&start=&query=&sorting=&playerToBeReplacedById=&max=' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "it": []
}
Previous
GET /v4/challenges/{challengeId}/lineup/overview
Next
GET /v4/challenges/{challengeId}/lineup/teams
Built with