Teams

GET /teams

Returns all 18 AFL teams, ordered alphabetically.

Query Parameters

Name	Type	Required	Description
limit	integer	No	Default 50, max 200
offset	integer	No	Default 0

Response

{
  "data": [
    { "id": "adelaide-crows", "name": "Adelaide Crows", "shortName": "ADL" },
    { "id": "brisbane-lions", "name": "Brisbane Lions", "shortName": "BRL" }
  ],
  "meta": { "limit": 50, "offset": 0, "count": 18, "total": 18 }
}

GET /teams/:id

Returns a single team by its slug ID.

Path Parameters

Name	Type	Description
id	string	Team slug, e.g. `sydney`

Response

{
  "data": { "id": "sydney", "name": "Sydney Swans", "shortName": "SYD" }
}

GET /teams/:id/stats

Returns aggregated team statistics per match. Each row sums all player stats for that team in a single match. Useful for comparing team-level performance across a season.

Parameters

Name	Type	Required	Description
id	string	Yes (path)	Team slug
year	integer	No	Filter by season year
round	integer	No	Filter by round
limit	integer	No	Default 50, max 200
offset	integer	No	Default 0

Response

{
  "data": [
    {
      "matchId": 9812, "round": 5, "year": 2024,
      "opponent": "Greater Western Sydney", "opponentShortName": "GWS",
      "isHome": true, "teamScore": 104, "opponentScore": 87,
      "kicks": 210, "handballs": 158, "disposals": 368,
      "marks": 95, "goals": 16, "behinds": 8,
      "tackles": 62, "hitouts": 38, ...
    }
  ],
  "meta": { "limit": 50, "offset": 0, "count": 22, "total": 22 }
}