Ratings snapshot
The table exactly as it stood on a date, built only from matches that started before it.
Analystonly
Parameters
All optional, all in the query stringondateThe date to rebuild the table as of, YYYY-MM-DD. Only matches that started before it count.
limitintHow many to return. Default 50, at most 200.
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 | 2268 |
matches | number | 797 |
last_match | date | "2025-01-01" |
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. |