Overview

Returns the current squad roster for a club, including each player’s Transfermarkt player ID, shirt number, captain status, and squad classification. Use it to retrieve a club’s player IDs and basic squad composition.

Inputs

id (string, optional in the endpoint definition): Transfermarkt club ID. Example: 418.

Response

Successful responses have the following structure:

success (boolean): Indicates whether the request succeeded.
message (string): Response message, such as "OK".
data (object): Squad result containing:
clubId (string): The requested club ID.
squad (array): Squad entries. Each entry contains:
playerId (string): Transfermarkt player ID.
clubId (string): Club ID associated with the entry.
shirtNumber (number): Player’s shirt number.
isCaptain (boolean): Whether the player is marked as captain.
type (string): Squad classification; the verified response returned "current".
playerIds (array of strings): Player IDs included in the squad.
localCount (number): Count of local players in the returned squad classification.
foreignCount (number): Count of foreign players.
nationalCount (number): Count of national players.

Auth & browser

Authentication is not required. The endpoint is configured as a direct GET request without browser context or fetch-based execution requirements.

Examples

Request

{
  "id": "418"
}

Success response

Verified with club ID 418:

{
  "success": true,
  "message": "OK",
  "data": {
    "clubId": "418",
    "squad": [
      {
        "playerId": "108390",
        "clubId": "418",
        "shirtNumber": 1,
        "isCaptain": false,
        "type": "current"
      },
      {
        "playerId": "404839",
        "clubId": "418",
        "shirtNumber": 13,
        "isCaptain": false,
        "type": "current"
      },
      {
        "playerId": "369081",
        "clubId": "418",
        "shirtNumber": 8,
        "isCaptain": true,
        "type": "current"
      },
      {
        "playerId": "971570",
        "clubId": "418",
        "shirtNumber": 9,
        "isCaptain": false,
        "type": "current"
      },
      {
        "playerId": "1063338",
        "clubId": "418",
        "shirtNumber": 19,
        "isCaptain": false,
        "type": "current"
      }
    ],
    "playerIds": [
      "108390",
      "404839",
      "413112",
      "369081",
      "971570",
      "1063338"
    ],
    "localCount": 7,
    "foreignCount": 20,
    "nationalCount": 20
  }
}

Notes

The verified response contained more squad entries than shown above; the example is shortened for readability.
The endpoint’s returned squad array and playerIds list should be treated as variable-length collections.
Use the returned playerId values with player-specific endpoints when more detailed player information is needed.