Skip to main content
GET
List football matches

What it returns

Football matches, filterable by status (comma-separated, e.g. live,not_started) and date (YYYY-MM-DD, on scheduled time). Live matches sort first, then by kickoff. Each row carries the match shape: stable id (sr:sport_event:{int}) + uuid, numeric sport_event_status, string status, match_status (period), live score, home/away competitors with qualifier + icon_path, nested tournament and category, and the raw coverage block.

Common queries

Authorizations

X-API-Key
string
header
required

Query Parameters

status
string | null

Comma-separated SR statuses

date
string | null

YYYY-MM-DD filter on scheduled time

limit
integer
default:50
Required range: 1 <= x <= 200

Response

Successful Response

The response is of type Response List Matches Soccer V1 Matches Get · object.

Last modified on June 20, 2026