Ratings
The current table.
Livelast 30 days
Archive and upwhole archive
Cursor paging
Parameters
All optional, all in the query stringlimitintHow many to return. Default 50, at most 200.
cursorcursorCarry on from here: pass back meta.next_cursor exactly as it came.
Try it
Your key, sent from your browser straight to the APIPaste your keyGet a free one in a minute
Run it to see your limits
What comes back
Each item in data, read from a real response| Field | Type | Example |
|---|---|---|
rank | number | 1 |
player_id | id | "pl_VEB8HM" |
name | string | "Luke Littler" |
country_code | string | "gb-eng" |
rating | number | 2415.6 |
change_30d | number | 8.5 |
matches | number | 1066 |
last_match | date | "2026-09-20" |
peak | object | { rating, on } |
meta.next_cursor | string | Pass back as cursor for the next page; null on the last |
When it refuses
Every error code| Status | Code | When |
|---|---|---|
| 401 | no_key | No key, a malformed key, or one that is not ours. |
| 402 | upgrade_required | Your plan does not reach this endpoint. The message names the plan that does. |
| 422 | bad_parameter | A parameter is malformed or out of range, named in the message. |
| 429 | rate_limited | Over your rate or allowance. Retry-After says when. |