Players

GET /players

Returns players ordered alphabetically. Filter by team, search by name, or filter by season year (players who appeared in at least one match that year).

Query Parameters

Name	Type	Required	Description
team_id	string	No	Filter by current team slug
name	string	No	Partial name search (case-insensitive)
year	integer	No	Only players who played in this season
limit	integer	No	Default 50, max 200
offset	integer	No	Default 0

Examples

# Search for a player by name
GET /players?name=warner

# All Collingwood players who played in 2024
GET /players?team_id=collingwood&year=2024

Response

{
  "data": [
    { "id": 144, "name": "Chad Warner", "currentTeamId": "sydney", "onlineId": "12345" }
  ],
  "meta": { "limit": 50, "offset": 0, "count": 1, "total": 1 }
}

GET /players/:id

Returns a single player by numeric ID.

Response

{
  "data": { "id": 144, "name": "Chad Warner", "currentTeamId": "sydney", "onlineId": "12345" }
}

GET /players/:id/career

Returns career totals and per-game averages for a player across all seasons in the database.

Response

{
  "data": {
    "playerId": 144,
    "playerName": "Chad Warner",
    "currentTeamId": "sydney",
    "gamesPlayed": 85,
    "totals": { "kicks": 1020, "handballs": 780, "disposals": 1800, ... },
    "averages": { "kicks": 12.0, "handballs": 9.18, "disposals": 21.18, ... }
  }
}

GET /players/:id/season

Returns season totals and per-game averages for a player in a specific year.

Query Parameters

Name	Type	Required	Description
year	integer	Yes	Season year

Response shape is identical to /players/:id/career but scoped to the given year.