Skip to main content
GET
/
matches
/
{matchId}
Get match detail
curl --request GET \
  --url https://teambattles.gg/api/v1/matches/{matchId} \
  --header 'Authorization: Bearer <token>'
{
  "match": {
    "id": "<string>",
    "publishStatus": "<string>",
    "game": {
      "id": "<string>",
      "nameKey": "<string>"
    },
    "gameMode": "<string>",
    "creatorTeam": {
      "id": "<string>",
      "name": "<string>",
      "tag": "<string>",
      "avatarUrl": "<string>",
      "score": 0
    },
    "acceptedTeam": {
      "id": "<string>",
      "name": "<string>",
      "tag": "<string>",
      "avatarUrl": "<string>",
      "score": 0
    },
    "bestOf": 0,
    "teamSize": 0,
    "selectedMaps": [
      "<string>"
    ],
    "selectedObjectives": [
      "<string>"
    ],
    "winnerTeamId": "<string>",
    "scheduledAt": "<string>",
    "startedAt": "<string>",
    "completedAt": "<string>",
    "createdAt": "<string>",
    "matchType": "<string>",
    "platform": "<string>",
    "region": "<string>",
    "challengedTeam": {
      "id": "<string>",
      "name": "<string>",
      "tag": "<string>",
      "avatarUrl": "<string>",
      "score": 0
    },
    "leagueId": "<string>",
    "leagueSeasonId": "<string>"
  },
  "timestamp": "<string>"
}

​
Permission Required

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

​
Access Rules

TeamBattles staff can read any match. Active members of creator or accepted teams can read the match. Active members of a challenged team can read pending challenge details. Draft matches are limited to creator-team captains and staff.

Authorizations

​
Authorization
string
header
required

Send your API key as: Authorization: Bearer tb_

Path Parameters

​
matchId
string
required

Match ID.

Response

Match detail.

SP-2 match detail response.

​
match
object
required

Participant-gated SP-2 match detail. Lobby codes are intentionally omitted.

​
timestamp
string
required