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

This endpoint takes no query parameters.

​
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

curl -s "https://api.squadassist.ai/v1/player_positions" \
  -H "x-api-key: YOUR_API_KEY"
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" }
  ]
}