Skip to main content
The POST /get_sportive_impact endpoint calculates the sportive (on-field) impact of a player joining a specific club. It uses SquadAssist’s model to simulate how the player would affect the club’s squad and expected league position over a 3-year period. The result is expressed both as a monetary value — the revenue contribution the improvement is expected to generate — and as concrete simulation metrics such as the change in expected finishing position and projected playing time. This is the on-field component of the full ROI analysis; no transfer fee or wage inputs are needed here because those belong to the cost side of the calculation.
The analysis always uses the 2025/2026 season as the starting point. Season is not a request parameter. The club_id must be a club in your coverage.

​
Request

The request body must be a JSON object.
​
player_id
string
required
The SquadAssist player ID. Use POST /query_player to look up the ID from a Transfermarkt or Wyscout ID.
​
club_id
string
required
The SquadAssist club ID for the club the player would be joining. The model compares the player against the club’s existing squad to determine playing time and positional improvement. Use POST /query_club to look up the ID.
​
currency_code
string
An ISO 4217 currency code (e.g. EUR, GBP, USD). The on-field monetary value will be returned in this currency alongside the EUR value. Defaults to EUR.

​
Response

​
currency
string
The ISO 4217 currency code for the on_field_value output. Matches your currency_code input, or EUR if none was provided.
​
on_field_value
integer
The estimated monetary value of the player’s on-field contribution to the club over the 3-year simulation, in the requested currency. This reflects the additional revenue the club is expected to generate from the improvement in league position.
​
on_field_value_in_eur
integer
The estimated on-field value contribution, in EUR.
​
simulation
object
The league position simulation results showing how the player changes the club’s expected finishing position.
​
playing_time_percentage
number
The projected fraction of available matches the player is expected to participate in at the signing club (0.0–0.9). For example, 0.72 means the player is expected to play in approximately 72% of matches.

​
Example

curl -X POST https://api.squadassist.ai/v1/get_sportive_impact \
  -H "x-api-key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "player_id": "P01JJ9Q8SSAA1PN94F070VGY9Q3",
    "club_id": "C01JJBVJAPKG8CM7ZA5JF5G84R8",
    "currency_code": "EUR"
  }'

​
Errors

StatusBodyCause
400{"error": "player_id is required"}player_id was not included in the request body
400{"error": "club_id is required"}club_id was not included in the request body
400{"error": "Invalid player_id"}The player_id format is not valid
400{"error": "Invalid club_id"}The club_id format is not valid
400{"error": "currency_code must be a string"}currency_code was provided but is not a string
400{"error": "<message>"}The currency_code is not a valid ISO 4217 code
403{"error": "Player is not in the allowed leagues"}The player is not in the Belgian Jupiler Pro League
403{"error": "Requested club is not allowed"}The club_id is not available on your plan
404{"error": "Club not found"}No club was found for the provided club_id