Mojang · JSON Structure

Minecraft Services Minecraft Access Token Structure

Successful response from /authentication/login_with_xbox.

Type: object Properties: 5 Required: 1
Games And ComicsMinecraftGamingIdentityPlayer ProfilesSessionPublic APIs

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

Properties

username roles access_token token_type expires_in

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/minecraft-services-minecraft-access-token-structure.json",
  "name": "MinecraftAccessToken",
  "description": "Successful response from /authentication/login_with_xbox.",
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "Internal Mojang account UUID (different from the player UUID).",
      "example": "0c11b18a48e94c8d8d8c8f2b3a4e1234"
    },
    "roles": {
      "type": "array",
      "description": "Account roles array (typically empty for player accounts).",
      "items": {
        "type": "string"
      },
      "example": []
    },
    "access_token": {
      "type": "string",
      "description": "Minecraft Bearer access token.",
      "example": "eyJraWQiOiJhYmMxMjMi..."
    },
    "token_type": {
      "type": "string",
      "description": "Token type (always `Bearer`).",
      "example": "Bearer"
    },
    "expires_in": {
      "type": "int32",
      "description": "Token lifetime in seconds.",
      "example": 86400
    }
  },
  "required": [
    "access_token"
  ]
}