Check if you own a copy of Minecraft

This endpoint allows an authenticated user to check if they own a copy of Minecraft.

Request

  • Method: GET
  • Endpoint: /entitlements/mcstore
  • Full URL: https://api.minecraftservices.com/entitlements/mcstore
  • Headers:
    • Authorization: Bearer [JWT/auth token here]

Response

200: OK

Successfully retrieved the account entitlements.

// when you do own a copy of the game { "items": [ { "name": "product_minecraft", "signature": "JWT here" }, { "name": "game_minecraft", "signature": "JWT here" } ], "signature": "JWT here", "keyId": "1" } // when you do not own a copy of the game { "items": [], "signature": "JWT here", "keyId": "1" }

If you do not own a copy of Minecraft, the items array will be empty.

Inside the signature JWTs for product_minecraft and game_minecraft, the body is:

{ "signerId": "2556731038473355", "name": "game_minecraft" // can also be product_minecraft }

Inside the signature JWT that is outside the items array, the body is:

{ "entitlements": [ { "name": "product_minecraft" }, { "name": "game_minecraft" } ], "signerId": "2556731038473355", "nbf": 1624461990, "exp": 1624634970, "iat": 1624462170 }

400: Bad Request

This status code is returned when you are trying to use a Mojang account with this endpoint.

{ "path": "/entitlements/mcstore", "errorType": "Bad Request", "error": "Bad Request", "errorMessage": "Required JWT [user] not specified", "developerMessage": "Required JWT [user] not specified" }