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
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=2Response
{
"total": 15000,
"cached_since": "2021-03-08T04:29:04+00:00",
"entries": [
{
"rank": 2,
"dead": false,
"online": true,
"public": true,
"character": {
"id": "b23f488245ffebc87616c9acf76fbbb3d534e0490a8b30a9be48f8fcc3941be0",
"name": "TaylorSwiftVEVO",
"level": 100,
"class": "Scion",
"score": 65425,
"experience": 4250334444
},
"account": {
"name": "PeakingDuck",
"realm": "pc",
"challenges": {
"total": 35
},
"twitch": {
"name": "peakingduck"
}
}
},
{
"rank": 3,
"dead": false,
"online": false,
"character": {
"id": "41240e2f9f7a56ebb409d6060619a14ffba154c61a84ef769bc9758361351ae8",
"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=NormalResponse
{
"total": 29,
"title": "Labyrinth - Standard (Normal)",
"startTime": 1615161600,
"entries": [
{
"online": false,
"rank": 3,
"time": 348,
"public": true,
"character": {
"id": "8f715d6bdb46b230a1c296c61329b7bcef6cb72f76a3b1a2410a4a2dfe783946",
"name": "GKO_Werkis",
"level": null,
"class": "Duelist",
"experience": null
},
"account": {
"name": "talostaf",
"realm": "pc",
"challenges": {
"total": 9
}
}
}
]
}
