GET /eventsFree key, archive on paidMCP: find_events

Snooker API: Events: every tournament and championship, newest first

Events: every tournament and championship, newest first.

GEThttps://api.snookerapi.net/v1/events

Try it

seasonyeartourcompetition_idqpagecursorper_page

Parameters

Name	Type	What it is
season	season	Season, e.g. 2025-26.
year	year	Calendar year the event started in.
tour	string	Which tour: amateur is the IBSF, EBSA and ACBS championships and their junior events; q_tour the development tour (the Q Tour and the Challenge Tour before it), a season to an event, its events as rounds. professional women seniors q_school amateur q_tour
competition_id	id	Only this competition (cp_ id).
q	string	Words in the event name.
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
id	string	The record's own id: stable, and the same in every call.
name	string	The name, as we hold it.
season	string or null	The season, as 2025-26.
tour	string	professional, women, seniors or q_school.
kind	string or null	ranking or invitational, where it is known.
competition	object	The competition it is an edition of: id and name.
start_date	date or null	The first day.
end_date	date or null	The last day.
held_in	string or null	The month or year, for an event whose days are not known.
venue	string or null	The venue.
town	string or null	The town or city.
country	string or null	The country.
location	object or null	Where the event was played: lat and lon, and basis (venue for the venue's own coordinates, town where only the town's are known). Null where neither is known.
time_zone	string or null	The venue's time zone, as Europe/London. Every time the API gives is UTC; this is for showing it locally.
utc_offset	string or null	The venue's offset from UTC on the first day, summer time included, as +01:00.
winner	object or null	The champion: id and name.
runner_up	object or null	The runner-up: id and name.
final_score	string or null	The final's score, as 18-14.
highest_break	integer or null	The event's highest break: the article's figure, or else the highest main-stage century in its century list.
highest_break_basis	string or null	Where highest_break comes from: article (the event's own figure), german_article (the German article's figure, where the English one gives none) or century_list (the highest century it lists).
prize_fund	string or null	The total prize fund, as published.
matches	integer	How many matches are held.

Example answer

A real answer, read from the data within the last hour: GET /v1/events?q=World+Snooker+Championship&per_page=2

{
    "data": [
        {
            "id": "ev_z867dfpm",
            "name": "2027 World Snooker Championship",
            "season": "2026-27",
            "tour": "professional",
            "kind": "ranking",
            "competition": {
                "id": "cp_19bahdvy",
                "name": "World Snooker Championship"
            },
            "start_date": "2027-04-17",
            "end_date": "2027-05-03",
            "held_in": null,
            "venue": "Crucible Theatre",
            "town": "Sheffield",
            "country": "England",
            "location": {
                "lat": 53.38111,
                "lon": -1.46667,
                "basis": "venue"
            },
            "time_zone": "Europe/London",
            "utc_offset": "+01:00",
            "winner": null,
            "runner_up": null,
            "final_score": null,
            "highest_break": null,
            "highest_break_basis": null,
            "prize_fund": "£3,000,000",
            "matches": 0
        },
        {
            "id": "ev_80r2d1px",
            "name": "2026 World Snooker Championship",
            "season": "2025-26",
            "tour": "professional",
            "kind": "ranking",
            "competition": {
                "id": "cp_19bahdvy",
                "name": "World Snooker Championship"
            },
            "start_date": "2026-04-18",
            "end_date": "2026-05-04",
            "held_in": null,
            "venue": "Crucible Theatre",
            "town": "Sheffield",
            "country": "England",
            "location": {
                "lat": 53.38111,
                "lon": -1.46667,
                "basis": "venue"
            },
            "time_zone": "Europe/London",
            "utc_offset": "+01:00",
            "winner": {
                "id": "pl_ra6m6b4g",
                "name": "Wu Yize"
            },
            "runner_up": {
                "id": "pl_w2c64qam",
                "name": "Shaun Murphy"
            },
            "final_score": "18-17",
            "highest_break": 147,
            "highest_break_basis": "article",
            "prize_fund": "£2,395,000",
            "matches": 143
        }
    ],
    "meta": {
        "plan": "House key",
        "count": 2,
        "next_cursor": "bzIuMjY0ZmE2",
        "page": 1,
        "per_page": 2,
        "total": 96,
        "total_pages": 48,
        "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

PreviousChangelog NextGET /v1/events/{event_id}