Matches

GET /matches

Returns matches with scores, teams, venue, and crowd. Ordered newest first (year desc, round desc).

Query Parameters

Name	Type	Required	Description
year	integer	No	Filter by season year
round	integer	No	Filter by round (0 = finals)
team_id	string	No	Matches involving this team (home or away)
venue	string	No	Filter by venue name (exact match)
date_from	string	No	ISO date, e.g. `2024-01-01`
date_to	string	No	ISO date (inclusive)
limit	integer	No	Default 50, max 200
offset	integer	No	Default 0

Examples

# All Sydney Swans matches in 2024
GET /matches?team_id=sydney&year=2024

# Matches at the MCG in a date range
GET /matches?venue=MCG&date_from=2024-06-01&date_to=2024-06-30

# Round 10, 2024
GET /matches?year=2024&round=10

Response

{
  "data": [
    {
      "id": 9812, "round": 5, "year": 2024,
      "homeTeam": "Sydney Swans", "homeShortName": "SYD",
      "awayTeam": "Greater Western Sydney", "awayShortName": "GWS",
      "homeScore": 104, "awayScore": 87,
      "venue": "SCG", "date": "2024-04-20T13:45:00",
      "crowd": 38214, "sourcedAt": "2024-04-21T00:12:44.231Z"
    }
  ],
  "meta": { "limit": 50, "offset": 0, "count": 9, "total": 9 }
}

GET /matches/:id

Returns a single match by numeric ID.

Response shape is the same as a single item from GET /matches, wrapped in { "data": { ... } }.