Skip to content
JavaScript interface for the Hi-Rez Paladins API
Branch: master
Clone or download
Latest commit 83c499e Oct 20, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information. changed player to playerId Apr 19, 2017
LICENSE Update license Oct 19, 2018
constants.js Created constants file and added language codes. Mar 13, 2017
package.json Update Readme Oct 20, 2018
paladins-api.js Refactoring Oct 19, 2018

Welcome to the paladins-api Wrapper!

This is a Javascript wrapper for the Paladins API to simplify making requests and handling the responses.

Current version is v1.3.1 - Changelog

Note: This wrapper is still in early stages of development. Some API methods are not yet implemented.



1. Install the package using npm install.

npm install paladins-api --save

Setting Up

1. Import the package to your entry file. Ex. app.js

const paladins = req('paladins-api');

2. Create a new instance of the api class.

const pal = new paladins('your-dev-id', 'your-auth-key');

Note: Development credentials can be obtained by completing this application.

Creating a Session

Note: Hi-Rez has limits set in place to throttle requests and sessions. Sessions expire after 15 min so re-creating a session when needed is something that needs to be implemented by yourself.

1. Create a new session using the connect() method.

var sessionId;
  (err, res) => {
    if (!err) {
      sessionId = res;

First we create a variable called sessionId so that we can store the session returned from the connect() method.

In the connect() method we have a call back function which returns the session in the res variable. We check for error's and then store the session into the sessionId variable.

Usage (Get a player's stats)

This example is just to demonstrate how the process works. We're going to retrieve a players statistics using the getPlayer() method.

Every method we use requires a valid session variable to be passed into the function. This is required for signature generation and validation on Hi-Rez's end.

1. Create a session using the connect() method.

2. Call the method using the sessionsId and the Player's username.

pal.getPlayer(sessionId, "PC", "HiRez", (err, res) => {

3. The response that gets returned is an object that we can now use in our application. In this case, we just console log to make sure it's working.

Note: Player name 'HiRez' returns an empty object because the player does not exist...


connect() - Returns a session variable that's required for all API calls.

getPlayer(session, platform, player) - Returns an object with basic player statistics.

getMatchHistory(session, platform, player) - Returns a list of the players most recent matches (50).

getMatchDetails(session, platform, match_id) - Returns details of a specific match.

getChampions(session, platform) - Returns a list of all the champions and details about them.

getItems(session, platform) - Returns all the items in the game, including cards, items etc...

getDataUsed(session, platform) - Returns an object containing resources used.

getPlayerStatus(session, platform, player) - Returns the current status of the player. (offline, in-lobby etc.)

getChampionSkins(session, platform, champ_id) - Returns all skins available for chosen champion.

getChampionRanks(session, platform, player) - Returns details of the players performance with all champions.

getPlayerLoadouts(session, platform, playerId) - Returns champion loadouts for player.

Note: More methods will be added in the future.


You can’t perform that action at this time.