---
title: "Join a live game by code"
method: POST
path: "/api/games/live/join"
tags: ["Games"]
---

# Join a live game by code

`POST /api/games/live/join`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/games/live/join`
- Auth: HTTP bearer

## Request body

- object
  - `code` string, required
  - `via` 'scan' | 'code': Use scan only when the game was joined from a QR scan.

## Response `200`

{ player, session }; scan joins may return gameServices: { firstEver? }. The block is omitted when the best-effort milestone claim fails.

## Other responses

- `400`: VALIDATION_ERROR
- `401`: UNAUTHORIZED
- `404`: NOT_FOUND
- `409`: CONFLICT

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - added the new optional request property `via`
- **2026-08-26** `18a435e8381e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/games/live/join/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
