> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squadassist.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get all players in your coverage

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

<Steps>
  <Step title="Look up all competitions">
    Use `GET /get_competitions`to get all competitions you have access to.

    ```shellscript theme={null}
    curl https://api.squadassist.ai/v1/competitions -H @{"x-api-key"= "YOUR_API KEY"}
    ```

    The response gives you the competitions you have access to:

    ```json theme={null}
    {
      "competitions": ["BELGIAN_JUPILER_PRO_LEAGUE","ENGLISH_PREMIER_LEAGUE"]
    }
    ```
  </Step>

  <Step title="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 

    ```bash wrap theme={null}
    $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.

    ```json theme={null}
    {
    	"clubs": 
      	[
    		{
    		"squadassist_id": "C01JJBSWKE71ZEN2E52257YQGP5",
    		"transfermarkt_id": 520, 
    		"name" : "Cercle Brugge"
    		},
    	...
    	]

    }
    ```
  </Step>

  <Step title="Get all players playing at each club ">
    `GET /get_players_at_club`gives 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.  

    ```bash theme={null}
    $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.

    ```json theme={null}
    {
    	"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",
            },
    	...
    	]

    }
    ```
  </Step>
</Steps>

## 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