Players

Player objects contain aggregated lifetime information about each Player.

Get a Single Player

This endpoint retrieves a specific player.

  • If a player has changed names, it is possible that there are multiple ID’s for a single player name.
  • Player renames do not trigger a change on this endpoint. A minimum of 1 match after the rename is required to view the change.

HTTP Request

GET https://api.dc01.gamelockerapp.com/shards/na/players/<ID>

URL Parameters

Parameter Default Description
ID none The ID of the player to retrieve

Shell:

curl "https://api.dc01.gamelockerapp.com/shards/na/players/<ID>" \
-H "Authorization: Bearer <api-key>" \
-H "Accept: application/vnd.api+json"

The above commands returns JSON structured like this:

{
  "data": {
    "type": "player",
    "id": "6abb30de-7cb8-11e4-8bd3-06eb725f8a76"
    "attributes": {
      "name": "boombastic04",
      "patchVersion": "2.9",
      "shardId": "na"
      "stats": {
        "lossStreak": 1,
        "winStreak": 0,
        "lifetimeGold": 10536.0
      },
      "titleID": "semc-vainglory",
    },
  }
}

Get a Collection of Players

This endpoint retrieves a collection of up to 6 players, filtered by name or id. Player names are specific to each region.

HTTP Request

GET https://api.dc01.gamelockerapp.com/shards/na/players

Query Parameters

Parameter Default Description
filter[playerNames] none Filters by player names. Usage: filter[playerNames]=player1,player2
filter[playerIds] none Filters by player id’s. Usage: filter[playerIds]=id1,id2,…

Shell:

curl "https://api.dc01.gamelockerapp.com/shards/na/players?filter[playerNames]=player1,player2" \
-H "Authorization: Bearer <api-key>" \
-H "Accept: application/vnd.api+json"