Skip to main content
This guide walks you through the complete flow to get all players in your coverage.

​
Prerequisites

Before you start, make sure you have:
  • A SquadAssist account with an API key
  • curl available in your terminal (all examples below use curl)

​
Step-by-step

1

Look up all competitions

Use GET /get_competitionsto get all competitions you have access to.
curl https://api.squadassist.ai/v1/competitions -H @{"x-api-key"= "YOUR_API KEY"}
The response gives you the competitions you have access to:
{
  "competitions": ["BELGIAN_JUPILER_PRO_LEAGUE","ENGLISH_PREMIER_LEAGUE"]
}
2

Get the clubs playing in that league

GET /get_clubs_in_competition gives you all clubs currently playing in the competition. If you loop over the competitions from your earlier request, this gives you all of the clubs currently playing in these leagues 
$headers = @{
    "x-api-key"    = "YOUR_API_KEY"
    "Content-Type" = "application/json"
}

curl "https://api.squadassist.ai/v1/get_clubs_in_competition?competition=BELGIAN_JUPILER_PRO_LEAGUE" -H $headers
The response contains the full list of competitions, including their squadassist_ids.
{
	"clubs": 
  	[
		{
		"squadassist_id": "C01JJBSWKE71ZEN2E52257YQGP5",
		"transfermarkt_id": 520, 
		"name" : "Cercle Brugge"
		},
	...
	]

}
3

Get all players playing at each club

GET /get_players_at_clubgives you all clubs currently playing at the requested club. If you loop over the clubs from your earlier request, this gives you all of the players currently playing in your coverage.  
$headers = @{
    "x-api-key"    = "your_API_key"
    "Content-Type" = "application/json"
}

curl "https://api.squadassist.ai/v1/get_players_at_club?club_id=C01JJBSWKE71ZEN2E52257YQGP5" -H $headers
The response contains the full list of players playing at that club, including their squadassist_ids.
{
	"season": "2025/2026",
	"club": 
		{
		"squadassist_id": "C01JJBSWKE71ZEN2E52257YQGP5",
		"transfermarkt_id": 520, 
		"name" : "Cercle Brugge"
		},
	"players": 
  	[
		{
            "squadassist_id": "P01J...",
            "transfermarkt_id": 175698,
            "wyscout_id": 169543,
            "first_name": "Nathan",
            "last_name": "De Cat",
            "alias": "N. De Cat",
            "name": "Nathan De Cat",
        },
	...
	]

}

​
What’s next

  • POST /get_future_transfer_value — project the resale value of a player at end of contract
  • GET /expected_transfer_value — get the current expected transfer fee for a player
  • GET /player_info — retrieve detailed position, role, and club affiliation data for a player