List the team roster

Players on the team, sorted by jersey number. Use a player id with player insights and to match box score rows.

GET

/v1/teams/{teamId}/roster

GET

/v1/teams/{teamId}/roster

curl -X GET "https://api.superstatsport.com/v1/teams/3fa85f64-5717-4562-b3fc-2c963f66afa6/roster" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

Authorization

Authorization
string
header
required
Club API key, for example ss_live_…. Create one in the Superstat app under Settings → API keys.

Parameters

teamId
string<uuid>
path
required
Team id.

Response

application/json

Success

data
RosterPlayer[]
required
error
object | null
required

{
  "data": [
    {
      "id": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
      "firstName": "Ava",
      "lastName": "Nguyen",
      "jerseyNumber": "7",
      "email": "[email protected]",
      "createdAt": "2025-02-20T09:12:00.000Z"
    }
  ],
  "error": null
}

GET

/v1/teams/{teamId}/roster

curl -X GET "https://api.superstatsport.com/v1/teams/3fa85f64-5717-4562-b3fc-2c963f66afa6/roster" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

{
  "data": [
    {
      "id": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
      "firstName": "Ava",
      "lastName": "Nguyen",
      "jerseyNumber": "7",
      "email": "[email protected]",
      "createdAt": "2025-02-20T09:12:00.000Z"
    }
  ],
  "error": null
}

- GETGet a team
- GETList the team roster

APITeams

List the team roster

Players on the team, sorted by jersey number. Use a player id with player insights and to match box score rows.

GET

/v1/teams/{teamId}/roster

GET

/v1/teams/{teamId}/roster

curl -X GET "https://api.superstatsport.com/v1/teams/3fa85f64-5717-4562-b3fc-2c963f66afa6/roster" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

Authorization

Authorization
string
header
required
Club API key, for example ss_live_…. Create one in the Superstat app under Settings → API keys.

Parameters

teamId
string<uuid>
path
required
Team id.

Response

application/json

Success

data
RosterPlayer[]
required
error
object | null
required

{
  "data": [
    {
      "id": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
      "firstName": "Ava",
      "lastName": "Nguyen",
      "jerseyNumber": "7",
      "email": "[email protected]",
      "createdAt": "2025-02-20T09:12:00.000Z"
    }
  ],
  "error": null
}

GET

/v1/teams/{teamId}/roster

curl -X GET "https://api.superstatsport.com/v1/teams/3fa85f64-5717-4562-b3fc-2c963f66afa6/roster" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

{
  "data": [
    {
      "id": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
      "firstName": "Ava",
      "lastName": "Nguyen",
      "jerseyNumber": "7",
      "email": "[email protected]",
      "createdAt": "2025-02-20T09:12:00.000Z"
    }
  ],
  "error": null
}