API Resources

Resource URL

http://api.pathofexile.com/ladders

Get a ladder

GET /ladders/:id

Get a ladder by league id. There is a restriction in place on the last ladder entry you are able to retrieve which is set to 15000.

Parameters

idRequired

The id (name) of the league for the ladder you want to retrieve.

realmOptional

The realm of the league for the ladder you want to retrieve: pc (default), xbox, or sony

limitOptional

Specifies the number of ladder entries to include. Default: 20, Max: 200.

offsetOptional

Specifies the offset to the first ladder entry to include. Default: 0.

typeOptional

Specifies the type of ladder: league (default), pvp, labyrinth

trackOptional

Adds unique IDs for each character returned. These can be used when name conflicts occur. Default: true

accountNameOptional

League only: Filters by account name within the first 15000 results.

difficultyOptional

Labyrinth only: Standard (1), Cruel (2), or Merciless (3)

startOptional

Labyrinth only: Timestamp of the ladder you want.

Example

http://api.pathofexile.com/ladders/Standard?offset=1&limit=2

Response

{
    "total": 15000,
    "cached_since": "2019-06-15T23:11:02+00:00",
    "entries": [
        {
            "rank": 2,
            "dead": false,
            "online": false,
            "character": {
                "name": "TaylorSwiftVEVO",
                "level": 100,
                "class": "Scion",
                "experience": 4250334444
            },
            "account": {
                "name": "PeakingDuck",
                "realm": "pc",
                "challenges": {
                    "total": 0
                },
                "twitch": {
                    "name": "peakingduck"
                }
            }
        },
        {
            "rank": 3,
            "dead": false,
            "online": false,
            "character": {
                "name": "Dear_Santa_UA",
                "level": 100,
                "class": "Occultist",
                "experience": 4250334444
            },
            "account": {
                "name": "Valerchik",
                "realm": "pc",
                "challenges": {
                    "total": 0
                }
            }
        }
    ]
}

Example

http://api.pathofexile.com/ladders/Standard?type=labyrinth&difficulty=Normal

Response

{
    "total": 653,
    "title": "Laberinto - Standard (Normal)",
    "startTime": 1560556800,
    "entries": [
        {
            "online": false,
            "rank": 3,
            "time": 368,
            "character": {
                "name": "testandi",
                "level": null,
                "class": "Duelist",
                "experience": null
            },
            "account": {
                "name": "Dr\u00e1curia",
                "realm": "pc",
                "challenges": {
                    "total": 11
                },
                "twitch": {
                    "name": "dracuria"
                }
            }
        }
    ]
}