Documentation / Rankings and breaks
Snooker API: Maximum breaks: every officially recognised 147, newest first, with the player, the opponent and the event
Maximum breaks: every officially recognised 147, newest first, with the player, the opponent and the event.
GEThttps://api.snookerapi.net/v1/maximums
Try it
Parameters
| Name | Type | What it is |
|---|---|---|
| player_id | id | Only this player's maximums (pl_ id). |
| season | season | Season, e.g. 2025-26. |
| year | year | Calendar year it was made in. |
| page | integer | Page number, from 1. |
| cursor | string | The next_cursor from the previous page. |
| per_page | integer | Rows per page. |
Returns
| Field | Type | What it holds |
|---|---|---|
| date | date or null | The day it was played or made, when known. |
| season | string or null | The season, as 2025-26. |
| player | object | The player: id and name. |
| opponent | object or null | The opponent: id and name. |
| event | object | The event: id, name and season. |
| match_id | string or null | The match it was made in, where we hold it. |
Example answer
A real answer, read from the data within the last hour: GET /v1/maximums?per_page=2
{
"data": [
{
"date": "2026-07-28",
"season": "2026-27",
"player": {
"id": "pl_2ykdqbh2",
"name": "Xiao Guodong"
},
"opponent": {
"id": "pl_7r9jtk6a",
"name": "Neil Robertson"
},
"event": {
"id": "ev_tbkgjcj9",
"name": "2026 Shanghai Masters"
},
"match_id": "mt_vchgze3q"
},
{
"date": "2026-07-24",
"season": "2026-27",
"player": {
"id": "pl_gv596prf",
"name": "Liam Highfield"
},
"opponent": {
"id": "pl_n4chrd0v",
"name": "Stephen Maguire"
},
"event": {
"id": "ev_g79fmgz7",
"name": "2026 British Open"
},
"match_id": "mt_jrysc9ep"
}
],
"meta": {
"plan": "House key",
"count": 2,
"next_cursor": "bzIuMjY0ZmE2",
"page": 1,
"per_page": 2,
"total": 246,
"total_pages": 123,
"next_page": 2,
"prev_page": null
}
}Errors
| Status | Code | When |
|---|---|---|
| 401 | unauthorized | No key, or a key that is not valid. Errors |
| 400 | bad_request | A parameter has the wrong shape. Errors |
| 422 | unknown_parameter | A parameter this call does not take. Errors |
| 429 | rate_limited | Too many calls this minute; wait for Retry-After. Errors |