Tournament Entry Requirements

Warning: Leaderboards and Tournaments is no longer supported. For questions about existing integrations, please contact your Amazon technical account manager.

Create entry requirement lists to filter the players that can enter (and/or view) your competition.

Overview

Use the Admin API to define requirement lists.
Use the Leaderboards and Tournaments Console or Admin API to attach the entry requirement list to the tournament.
In the Game API, include player attributes in the Enter Tournament request, so that the player will be accepted into the tournament.

Example

Admin API to define requirements

{
  "requirements": [
    {
      "name": "Player is VIP",
      "description": "The player has VIP status.",
      "type": "value",
      "key": "status",
      "value": "VIP"
    },
    {
      "name": "Player is a beginner",
      "description": "The player has a skill between 0 and 10.",
      "type": "range",
      "key": "League",
      "high": 10,
      "low": 0
    },
    {
      "name": "Greater Seattle Area",
      "description": "The GPS coordinates of the player is located in the Greater Seattle Area",
      "type": "gps",
      "key": "gpsCoordinates",
      "permittedAreas": [
        {
          "gpsCoordinates": {
            "latitude": 47.60604,
            "longitude": -122.3328
          },
          "radius": 10,
          "radiusUnits": "KILOMETERS"
        }
      ]
    }
  ]
}

Player enters the tournament

The following shows an example request body:

{
    "playerAttributes" : {
        "status" : "vip",
        "skill" : 1,
        "isActive" : true,
        "gpsCoordinates" : "{\"latitude\": 33.652275, \"longitude\": -117.750495}"
    },
    "accessKey" : "ADEF"
}

Last updated: Jun 11, 2025