SnookerAPI
Documentation / Rankings and breaks
GET /maximumsFree key, archive on paidMCP: maximum_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

Get a key

Parameters

NameTypeWhat it is
player_ididOnly this player's maximums (pl_ id).
seasonseasonSeason, e.g. 2025-26.
yearyearCalendar year it was made in.
pageintegerPage number, from 1.
cursorstringThe next_cursor from the previous page.
per_pageintegerRows per page.

Returns

FieldTypeWhat it holds
datedate or nullThe day it was played or made, when known.
seasonstring or nullThe season, as 2025-26.
playerobjectThe player: id and name.
opponentobject or nullThe opponent: id and name.
eventobjectThe event: id, name and season.
match_idstring or nullThe 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

StatusCodeWhen
401unauthorizedNo key, or a key that is not valid. Errors
400bad_requestA parameter has the wrong shape. Errors
422unknown_parameterA parameter this call does not take. Errors
429rate_limitedToo many calls this minute; wait for Retry-After. Errors