Path of Exile API

Games & Comics / OAuth Advanced HTTPS
76 B
Measured Score 0 50 100 Speed 16/30 Consistency 17/20 Security 20/20 Browser access 15/15 Transparency 8/15 TESTED 2026-08-10

Overview

The Path of Exile API gives you access to game data for the popular action RPG, including character builds, items, and league standings. You need to authenticate with OAuth to access player data and account information. It is great for building tools like build trackers or price checkers for PoE players.

Beginner Tip

Start by reading the official developer docs to understand OAuth scopes before making requests. Public endpoints like league listings require no auth, so test those first.

Measurement Record

What actually happened when we called this API from our own infrastructure. Every value below was recorded by the request, not copied from the provider's documentation.

Request
GET https://api.pathofexile.com/leagues?type=main&compact=1
Result
HTTP 200 · application/json · 2,688 bytes · compressed
Response time
232 ms (median of 3) · fastest 210 ms
Transport
TLSv1.3 · TLS_AES_256_GCM_SHA384 · certificate issued by Google Trust Services
Browser CORS
Allowed — Access-Control-Allow-Origin: *
Served by
cloudflare
Recorded
2026-08-10

Fields Returned

Top-level fields present in the response we captured, with the type and value we actually received.

Field Type Value received
id string Standard
name string Standard
realm string pc
url string (url) https://www.pathofexile.com/ladders/league/St…
startAt string (date) 2013-01-23T21:00:00Z
endAt null null

Captured Response

Captured from a real request to https://api.pathofexile.com/leagues?type=main&compact=1 on 2026-08-10. Long arrays and nested objects are truncated to keep the shape readable.

JSON Response · Captured
[
  {
    "id": "Standard",
    "name": "Standard",
    "realm": "pc",
    "url": "https://www.pathofexile.com/ladders/league/Standard",
    "startAt": "2013-01-23T21:00:00Z",
    "endAt": null
  }
]

Field Reference

id Unique identifier for the league (e.g., "Standard" or "Settlers")
realm Game realm the league belongs to, such as "pc", "xbox", or "sony"
url URL to the league information page on the official website
startAt ISO 8601 timestamp for when the league started
endAt ISO 8601 timestamp for when the league ends, or null if it is permanent

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://api.pathofexile.com/leagues?type=main&compact=1";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

How This API Fails

We deliberately sent this API a broken request and recorded exactly what came back on 2026-08-10. Knowing the shape of an error before you hit it makes error handling much easier to write.

HTTP 404 Requesting a path that does not exist application/json
{
  "error": {
    "code": 1,
    "message": "Resource not found"
  }
}
HTTP 400 Sending an invalid value for "type" application/json
{
  "error": {
    "message": "Unknown type '!!!invalid!!!'"
  }
}

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

401 Unauthorized Missing or expired OAuth token for protected endpoints
Complete the OAuth 2.0 flow to get a valid access token and include it as Authorization: Bearer YOUR_TOKEN
403 Forbidden OAuth token does not have the required scope for the requested data
Re-authenticate and request the necessary scopes (e.g., account:profile) in your OAuth authorization URL
429 Too Many Requests Exceeded the rate limit for the API
Check the X-Rate-Limit-* response headers and implement exponential backoff between requests

Measured Score Breakdown

Live HTTP request to the API endpoint

Speed 16/30
Consistency 17/20
Security 20/20
Browser access 15/15
Transparency 8/15
Endpoint Response Time 232ms

Fully tested on Aug 10, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS UNKNOWN
Category Games & Comics
Difficulty Advanced
Endpoint last called: 2026-08-10

Similar APIs

View All →