GetPlayerStats

Request

GET https://api.brawlhalla.com/v1/player/stats

Usage

This request returns information about a player’s life

Parameters

Parameter	Type	Required	Description
brawlhalla_id	Integer	✔️	The player’s Brawlhalla ID.
mode	string	❌	The modes to view data for. Accepts all, ranked_1v1, and ranked_3v3. If omitted, defaults to all.

Response

Ranked Example

{
  "brawlhalla_id": 4697805,
  "name": "Octavius",
  "games": 757,
  "wins": 693,
  "rating": 2143,
  "peak_rating": 2200,
  "tier": "Valhallan",
  "region": "US-E",
  "region_ranks": [
    {
      "region": "US-E",
      "rank": 1
    }
  ],
  "global_rank": 1,
  "legends": [
    {
      "legend_id": 35,
      "games": 757,
      "wins": 693,
      "rating": 2103,
      "peak_rating": 2160,
      "tier": "Bronze 1"
    },
    {
      "legend_id": 11,
      "games": 0,
      "wins": 0,
      "rating": 750,
      "peak_rating": 750,
      "tier": "Tin 1"
    }
  ]
}

All Example

{
  "brawlhalla_id": 5464542,
  "name": "Steampunk Dreams",
  "games": 3298,
  "wins": 1755,
  "xp": 408722,
  "xp_percentage": 0.8043252953775997,
  "level": 65,
  "damage_bomb": 36927,
  "damage_mine": 83153,
  "damage_spikeball": 27963,
  "damage_sidekick": 5611,
  "hit_snowball": 831,
  "ko_bomb": 11,
  "ko_mine": 25,
  "ko_sidekick": 16,
  "ko_snowball": 91,
  "ko_spikeball": 19,
  "region_ranks": [],
  "legends": [
    {
      "legend_id": 12,
      "games": 1127,
      "wins": 655,
      "damage_dealt": 227458,
      "damage_taken": 211662,
      "kos": 1001,
      "falls": 1006,
      "suicides": 25,
      "team_kos": 7,
      "match_time": 82349,
      "damage_unarmed": 4318,
      "damage_thrown_item": 469,
      "damage_weapon_one": 41464,
      "damage_weapon_two": 31979,
      "damage_gadgets": 5047,
      "ko_unarmed": 23,
      "ko_weapon_one": 326,
      "ko_weapon_two": 264,
      "ko_gadgets": 30,
      "time_held_weapon_one": 12376,
      "time_held_weapon_two": 32454,
      "xp": 159899,
      "level": 44,
      "xp_percentage": 0.06864801864801864
    }
  ]
}

Response Elements

Element	Type	Required	Mode	Description
brawlhalla_id	Integer	✔️	All & Ranked	The player’s Brawlhalla ID.
name	String	✔️	All & Ranked	The player’s current username.
games	Integer	✔️	All & Ranked	The total number of games this player has played.
wins	Integer	✔️	All & Ranked	The total number of wins this player has earned.
xp	Integer	❌	All	The player’s total account XP.
xp_percentage	Integer	❌	All	The player’s current progress towards the next account level.
level	Integer	❌	All	The player’s current account level.
damage_bomb	Integer	❌	All	The total amount of damage the player dealt with Bouncy Bombs.
damage_mine	Integer	❌	All	The total amount of damage the player dealt with Pressure Mines.
damage_spikeball	Integer	❌	All	The total amount of damage the player dealt with Spike Balls.
damage_sidekick	Integer	❌	All	The total amount of damage the player dealt with the Sidekick Summoner.
hit_snowball	Integer	❌	All	The number of times the player has hit someone with a Snowball.
ko_bomb	Integer	❌	All	The number of knockouts the player earned with Bouncy Bombs.
ko_mine	Integer	❌	All	The number of knockouts the player earned with Pressure Mines.
ko_sidekick	Integer	❌	All	The number of knockouts the player earned with the Sidekick Summoner.
ko_snowball	Integer	❌	All	The number of knockouts the player earned with Snowballs.
ko_spikeball	Integer	❌	All	The number of knockouts the player earned with Spike Balls.
rating	Integer	❌	Ranked	The current rating of the player.
peak_rating	Integer	❌	Ranked	The highest rating the player has achieved in the season.
tier	String	❌	Ranked	The current rating tier the player is in.
region	String	❌	Ranked	The region the player plays in.
region_ranks	String	❌	Ranked	The ranks the player holds in each region. This is a RegionRanks schema.
global_rank	Integer	❌	Ranked	The rank the player holds on the global leaderboards.
legends	Array (Object)	✔️	All & Ranked	An array of the player’s legend data. This is a Legend schema.