GET /player_info — Retrieve Player Details

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

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

string

The SquadAssist internal player ID, echoed back from the request.

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.

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.

string

The player’s nationality.

integer

The player’s current age in years.

string

The name of the agency of the player.

string

The end date of the current player’s contract.

string

The player’s preferred foot (e.g., "Right", "Left", "Both").

string

The SquadAssist ID of the club that holds the player’s registration.

string

The SquadAssist ID of the most recent club where the player was active.

string

The SquadAssist ID of the player’s current team (may differ from owning_club_id for loan players).

integer | null

The player’s Transfermarkt ID, or null if not linked.

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

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

Example

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

#Change player_id in request to desired player 
curl "https://api.squadassist.ai/v1/player_info?player_id=P01K0WPQJPWZCNCYH1KXHTJ9R31" -H $headers

    # 1. Define the endpoint with the player_id already in the URL
    url = "https://api.squadassist.ai/v1/player_info"
    player_id = "P01K0WPQJPWZCNCYH1KXHTJ9R31" # Change 

    # 2. Set up your headers
    headers = {
        "x-api-key": API_KEY, # Replace with your actual key
        "Content-Type": "application/json"
    }

    # 3. Add the parameters
    params = {
        "player_id": player_id 
    }

    # 4. Make the GET request
    response = requests.get(url, headers=headers, params=params)
    # 5. Output the result
    if response.status_code == 200:
        data = response.json()
        print(data)
    else:
        print(f"Error {response.status_code}: {response.text}")

library(httr2)

# 1. Define the base URL and the API key
base_url <- "https://api.squadassist.ai/v1/player_info"
api_key  <- "API_KEY"

# 2. Build the request
req <- httr2::request(base_url) |>
  httr2::req_headers("x-api-key" = API_KEY) |>
  # This adds the ?player_id=... part automatically
  httr2::req_url_query(player_id = "P01K0WPQJPWZCNCYH1KXHTJ9R31")

# 3. Perform and parse
resp <- httr2::req_perform(req)
player_info <- httr2::resp_body_json(resp)

print(player_info)

Response

{
  "squadassist_id": "P01K0WPQJPWZCNCYH1KXHTJ9R31",
  "player_role": "Box-to-Box Midfielder",
  "position": "CM",
  "nationality": "Belgium",
  "age": 17,
  "preferred_foot": "Right",
  "owning_club_id": "C01JJBVJAPKG8CM7ZA5JF5G84R8",
  "last_active_club_id": "C01JJBVJAPKG8CM7ZA5JF5G84R8",
  "current_team_id": "C01JJBVJAPKG8CM7ZA5JF5G84R8",
  "transfermarkt_id": 1105541,
  "wyscout_id": 777864
}

Overview

Players

Clubs

Competitions

Predictions

GET /player_info — Retrieve Player Details

Authentication

Request

Response

Errors

Example

​Authentication

​Request

​Response

​Errors

​Example

Authentication

Request

Response

Errors

Example