Skip to main content
GET
/
game
/
matches
/
{matchId}
Get a single match's details
curl --request GET \
  --url https://teambattles.gg/api/v1/game/matches/{matchId} \
  --header 'Authorization: Bearer <token>'
{
  "match": {
    "id": "<string>",
    "gameId": "<string>",
    "gameMode": "<string>",
    "bestOf": 0,
    "creatorTeam": {
      "_id": "<string>",
      "name": "<string>",
      "tag": "<string>"
    },
    "acceptedTeam": {
      "_id": "<string>",
      "name": "<string>",
      "tag": "<string>"
    },
    "creatorTeamScore": 0,
    "acceptedTeamScore": 0,
    "scheduledAt": "<string>",
    "startedAt": "<string>",
    "completedAt": "<string>",
    "createdAt": "<string>",
    "winnerTeamId": "<string>",
    "loserTeamId": "<string>",
    "leagueId": "<string>",
    "leagueSeasonId": "<string>"
  },
  "timestamp": "<string>"
}

​
Permission Required

This endpoint requires the game.lifecycle permission with read access. Your API key must be a game-developer key bound to a game. The binding asserts the match belongs to your bound game before the handler runs: a key bound to a different game, or a non-developer key, receives a 403 error_game_scope_mismatch.

​
Access / Membership Rules

The {matchId} must resolve to a match in your bound game. An unknown match returns 404 error_match_not_found.

​
What’s Returned

Returns { match, timestamp }. The match object carries the match id, gameId, gameMode, status, bestOf, both teams (creatorTeam / acceptedTeam as { _id, name, tag }), the aggregate creatorTeamScore / acceptedTeamScore, winnerTeamId / loserTeamId once decided, the ISO lifecycle timestamps (scheduledAt, startedAt, completedAt, createdAt), and leagueId / leagueSeasonId if the match belongs to a league.

Authorizations

​
Authorization
string
header
required

Send your API key as: Authorization: Bearer tb_

Path Parameters

​
matchId
string
required

Match ID.

Response

The requested match plus a response timestamp.

Envelope for GET /game/matches/{matchId}: the match plus a response timestamp.

​
match
object
required

Detailed match payload returned inside the game-developer match-detail response.

​
timestamp
string
required

Server response time (ISO 8601).