Mojang · JSON Structure

Session Server Join Request Structure

Body of the client-side /join call.

Type: object Properties: 3 Required: 3
Games And ComicsMinecraftGamingIdentityPlayer ProfilesSessionPublic APIs

JoinRequest is a JSON Structure definition published by Mojang, describing 3 properties, of which 3 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

accessToken selectedProfile serverId

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑ 
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/mojang/refs/heads/main/json-structure/session-server-join-request-structure.json",
  "name": "JoinRequest",
  "description": "Body of the client-side /join call.",
  "type": "object",
  "properties": {
    "accessToken": {
      "type": "string",
      "description": "Minecraft Bearer access token for the player.",
      "example": "eyJraWQiOiJhYmMxMjMi..."
    },
    "selectedProfile": {
      "type": "string",
      "description": "Player UUID without hyphens.",
      "example": "853c80ef3c3749fdaa49938b674adae6"
    },
    "serverId": {
      "type": "string",
      "description": "SHA-1 hash computed by the client during the handshake.",
      "example": "e6e0fce6f3a8b7afa3b9eb0a0d3a8e9a4e8c8e1b"
    }
  },
  "required": [
    "accessToken",
    "selectedProfile",
    "serverId"
  ]
}