Documentation / Rankings and breaks
Snooker API: Century breaks: every break of 100 or more in the events we hold, by event, player or season
Century breaks: every break of 100 or more in the events we hold, by event, player or season.
GEThttps://api.snookerapi.net/v1/centuries
Try it
Parameters
| Name | Type | What it is |
|---|---|---|
| event_id | id | Only this event (ev_ id), highest first. |
| player_id | id | Only this player's centuries (pl_ id). |
| season | season | Season, e.g. 2025-26. |
| stage | string | Main stage or qualifying. main qualifying |
| min_points | integer | Only breaks of at least this many points, e.g. 140. |
| 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 |
|---|---|---|
| event | object | The event: id, name and season. |
| player | object | The player: id and name. |
| points | integer or null | Ranking points, or the break's points. |
| stage | string | main, qualifying or pre_qualifying. |
Example answer
A real answer, read from the data within the last hour: GET /v1/centuries?event_id=ev_80r2d1px&per_page=3
{
"data": [
{
"event": {
"id": "ev_80r2d1px",
"name": "2026 World Snooker Championship",
"season": "2025-26"
},
"player": {
"id": "pl_p2pf44sw",
"name": "Chang Bingyu"
},
"points": 147,
"stage": "qualifying"
},
{
"event": {
"id": "ev_80r2d1px",
"name": "2026 World Snooker Championship",
"season": "2025-26"
},
"player": {
"id": "pl_yevzgv8d",
"name": "Oliver Sykes"
},
"points": 146,
"stage": "qualifying"
},
{
"event": {
"id": "ev_80r2d1px",
"name": "2026 World Snooker Championship",
"season": "2025-26"
},
"player": {
"id": "pl_zpmeb7ce",
"name": "Mark Allen"
},
"points": 145,
"stage": "main"
}
],
"meta": {
"plan": "House key",
"count": 3,
"next_cursor": "bzMuYjc3MjM0",
"page": 1,
"per_page": 3,
"total": 254,
"total_pages": 85,
"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 |