List Matches
Football matches filtered by status and date
GET
List football matches
What it returns
Football matches, filterable bystatus (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
Query Parameters
Comma-separated SR statuses
YYYY-MM-DD filter on scheduled time
Required range:
1 <= x <= 200Response
Successful Response
The response is of type Response List Matches Soccer V1 Matches Get · object.
Last modified on June 20, 2026
List football matches