Skip to main content
GET
List matches

Query Parameters

stage
enum<string>
Available options:
group,
r32,
r16,
quarter_finals,
semi_finals,
third_place,
final,
fifa_friendlies,
ucl,
uefa_europa_conference_league
tag
string

Single tag slug, exact match.

from
string<date-time>

ISO-8601 lower bound on the match's kickoff.

to
string<date-time>

ISO-8601 upper bound on the match's kickoff.

q
string

Case-insensitive substring filter on match.title. Whitespace is trimmed; empty strings are treated as no filter. Length bounds: 1–64 chars. Distinct from /api/search/matches?q=: this is a list-page filter (full match cards, chronological order); the search endpoint is ranked + paginated.

closed
boolean

Default false: matches with ≥1 tradeable market. true: matches with 0 tradeable markets and ≥1 closed market — the settled / finished tab. Accepts true/false/1/0.

offset
number

0-based offset into the result set. Defaults to 0.

limit
number

Page size, 1–500. Defaults to 500. limit_too_large (400) above the max.

Response

200 - application/json

OK

matches
object[]
required