Skip to main content
Use this endpoint to retrieve the full catalogue of player position codes and their corresponding display names as used throughout the SquadAssist platform. The id values returned here are the same codes you will see in the position field of GET /player_info.

​
Authentication

All requests must include a valid API key, either as an x-api-key header or as a Bearer token in the Authorization header. 
x-api-key: YOUR_API_KEY
# or
Authorization: Bearer YOUR_API_KEY

​
Request

​
player_id
string
required
The SquadAssist player ID. Obtain this from POST /query_player if you only have an external ID such as a Transfermarkt or Wyscout ID.

​
Response

​
positions
array
An array of position objects, one for each supported position.

​
Positions Reference

The table below lists every position returned by this endpoint.
CodeFull Name
GKGoalkeeper
LWBLeft Wing Back
LBLeft Back
CBCenter Back
RBRight Back
RWBRight Wing Back
CDMDefensive Midfielder
LMLeft Midfielder
CMCentral Midfielder
RMRight Midfielder
CAMAttacking Midfielder
LFLeft Forward
CFCenter Forward
RFRight Forward
LWLeft Wing
STStriker
RWRight Wing

​
Example

$headers = @{
    "x-api-key"    = "your API key" #Change 
    "Content-Type" = "application/json"
}

curl "https://api.squadassist.ai/v1/player_positions" -H $headers
Response
{
  "positions": [
    { "id": "GK",  "name": "Goalkeeper" },
    { "id": "LWB", "name": "Left Wing Back" },
    { "id": "LB",  "name": "Left Back" },
    { "id": "CB",  "name": "Center Back" },
    { "id": "RB",  "name": "Right Back" },
    { "id": "RWB", "name": "Right Wing Back" },
    { "id": "CDM", "name": "Defensive Midfielder" },
    { "id": "LM",  "name": "Left Midfielder" },
    { "id": "CM",  "name": "Central Midfielder" },
    { "id": "RM",  "name": "Right Midfielder" },
    { "id": "CAM", "name": "Attacking Midfielder" },
    { "id": "LF",  "name": "Left Forward" },
    { "id": "CF",  "name": "Center Forward" },
    { "id": "RF",  "name": "Right Forward" },
    { "id": "LW",  "name": "Left Wing" },
    { "id": "ST",  "name": "Striker" },
    { "id": "RW",  "name": "Right Wing" }
  ]
}