Skip to main content
Use this endpoint to retrieve detailed information about a specific player, including their SquadAssist role classification, current position code, club associations, and linked external IDs. All data is returned for the default season, which is currently 2025/2026.

​
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

​
squadassist_id
string
The SquadAssist internal player ID, echoed back from the request.
​
player_role
string
The player’s SquadAssist role classification (e.g., "Box-to-Box Midfielder", "Centre-Back"). Use GET /role_description to retrieve a full description of any role value.
​
position
string
The player’s primary position code (e.g., "CM", "ST", "CB"). Use GET /player_positions for the full list of valid codes and their names.
​
nationality
string
The player’s nationality.
​
age
integer
The player’s current age in years.
​
preferred_foot
string
The player’s preferred foot (e.g., "Right", "Left", "Both").
​
owning_club_id
string
The SquadAssist ID of the club that holds the player’s registration.
​
last_active_club_id
string
The SquadAssist ID of the most recent club where the player was active.
​
current_team_id
string
The SquadAssist ID of the player’s current team (may differ from owning_club_id for loan players).
​
transfermarkt_id
integer | null
The player’s Transfermarkt ID, or null if not linked.
​
wyscout_id
integer | null
The player’s Wyscout ID, or null if not linked.
Player data is always returned for the 2025/2026 season regardless of the current calendar date. Season selection is not supported on this endpoint.

​
Errors

StatusDescription
400player_id query parameter is missing or the value is invalid.
403Player is not yet ready for API access, or is not in the allowed leagues.
404No player found with the given player_id.

​
Example

curl -s "https://api.squadassist.ai/v1/player_info?player_id=P01JJBVJAPKG8CM7ZA5JF5G84R8" \
  -H "x-api-key: YOUR_API_KEY"
Response
{
  "squadassist_id": "P01JJBVJAPKG8CM7ZA5JF5G84R8",
  "player_role": "Box-to-Box Midfielder",
  "position": "CM",
  "nationality": "Belgium",
  "age": 26,
  "preferred_foot": "Right",
  "owning_club_id": "C01JJBVJAPKG8CM7ZA5JF5G84R8",
  "last_active_club_id": "C01JJBVJAPKG8CM7ZA5JF5G84R8",
  "current_team_id": "C01JJBVJAPKG8CM7ZA5JF5G84R8",
  "transfermarkt_id": 28003,
  "wyscout_id": 123456
}