AFL Stats API

Authentication

Every request (except Fixture) requires an API key passed via the Authorization header as a Bearer token. Keys are managed on the API Usage page after signing in. Get a free API key →

Authorization: Bearer YOUR_API_KEY

curl https://kaliaflstats.com/api/afl/v1/teams \
  -H "Authorization: Bearer a3f9c2d1e8..."

Base URL

https://kaliaflstats.com/api/afl/v1

All endpoint paths below are relative to this base. When running locally, use http://localhost:5173.

Response Format

All successful responses wrap data in a consistent envelope. List endpoints include a meta object for pagination. Single-resource endpoints return { "data": { ... } }.

{
  "data": [ ... ],
  "meta": {
    "limit":  50,
    "offset": 0,
    "count":  10,
    "total":  142
  }
}

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

Pagination

All list endpoints support limit and offset query parameters.

To iterate all records, keep fetching pages until offset + meta.count >= meta.total.

# Page 1
GET /players?limit=50&offset=0

# Page 2
GET /players?limit=50&offset=50

# Page 3
GET /players?limit=50&offset=100

Sorting

The player-stats and player-stats-advanced endpoints support dynamic sorting via sort_by and order query parameters.

# Top goal scorers in 2024, round 10
GET /player-stats?year=2024&round=10&sort_by=goals&order=desc

Errors

Error responses always include an error string.

Quick Reference

All endpoints at a glance. All require auth unless noted.