Skip to main content
GET
/
matches
/
{matchId}
/
players
Get match players
curl --request GET \
  --url https://teambattles.gg/api/v1/matches/{matchId}/players \
  --header 'Authorization: Bearer <token>'
{
  "matchId": "<string>",
  "players": [
    {
      "id": "<string>",
      "userId": "<string>",
      "teamId": "<string>",
      "username": "<string>",
      "name": "<string>",
      "isCheckedIn": true,
      "checkedInAt": "<string>",
      "avatarUrl": "<string>"
    }
  ],
  "timestamp": "<string>"
}

​
Permission Required

This endpoint requires one of matches.user_matches, matches.team_matches, or matches.org_matches with read access.

​
What’s Returned

Returns player rows with user and team IDs, roster type, check-in state, and attendance state. It does not return raw match player documents.

Authorizations

​
Authorization
string
header
required

Send your API key as: Authorization: Bearer tb_

Path Parameters

​
matchId
string
required

Match ID.

Response

Match player rows.

SP-2 match player rows response.

​
matchId
string
required
​
players
object[]
required
​
timestamp
string
required