Coverage MatrixDocumentationRelease LogLog In

Frequently asked questions for Aussie Rules Football v3

Click on the categories below or browse questions on the right panel.




What leagues or tournaments do you cover for Aussie Rules Football?

We cover the AFL tournament.

How do I find out the coverage for a particular match?

Within the Summaries and Timeline feeds, find the node for coverage. Coverage nodes have two types: season level and sport_event level.

  • The season level describes data coverage you can expect for matches involved in that given season.
  • The sport_event level describes the data depth of a specific match within the group and season.

Note: There are occasions when the sport_event coverage can vary from the anticipated season coverage. This node exists to highlight that in that event to assist in handling any discrepancies.

Why do different groups have coverage information for a tournament?

The notion of “groups” is versatile and is used to distinguish between playoffs and our tournaments structures. Therefore, it is necessary to describe coverage at a group level for consistency.

How will a sport event behave when it is not covered with live scores?

When a sport_event is not covered live, the status and match_status will remain as not_started until results are entered post-match.


How can I find the values for various enum data points within the API?

Many enum values are listed in the FAQ below. For the most up-to-date values, please see the Schema section of the OpenAPI specification here:

What format are date fields presented in?

When we present date only values we present these in the ISO 8601 standard format.

ex: 2013-04-03

We use these for attributes that have date and no time (such as birthdate). For more information:

What format are the date/time fields presented in?

All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.

ex: 2013-04-03T18:15:00+00:00

For more information:

How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or
cache-control: public, must-revalidate, max-age=120

Sport Event Statuses

What are the valid sport_event_statusstatus values?

  • not_started – The match is scheduled to be played
  • started - The match has begun
  • live – The match is currently in progress
  • postponed – The match has been postponed to a future date
  • suspended - The match has been suspended
  • match_about_to_start - The match is about to begin
  • delayed – The match has been temporarily delayed and will be continued. Typically appears prior to match start
  • interrupted - The match began, but coverage has stopped for a short time. Note that match scores may not be updated during this period, the last recorded match score will be displayed instead
  • cancelled – The match has been cancelled and will not be played
  • ended – The match is over
  • closed – The match results have been confirmed

What are the valid sport_event_statusmatch_status values?

  • not_started
  • aet
  • ended
  • postponed
  • cancelled
  • 1st_period
  • 2nd_period
  • 3rd_period
  • 4th_period
  • overtime
  • penalties
  • pause
  • awaiting_extra_time
  • awaiting_penalties
  • interrupted
  • abandoned
  • start_delayed
  • started


What are markets and what are the different markets?

Markets is something you can bet on that we provide probabilities for. Over time we intend to provide more and more markets in the API. Currently the only market we provide is 3-way (will the home team win? Or the away team? Or will it be a draw?).

What are the valid outcomes for probabilities?

  • home_team_winner
  • away_team_winner

What are the possible values for next_period?

  • 1st_quarter
  • 2nd_quarter
  • 3rd_quarter
  • 4th_quarter
  • extra_time
  • half_time

Past Season Data

How far back does the data go?

Only the current season and the previous season will be available in the API.

Player Data

Why do some score_change events not have player data?

No player data will be displayed for a rushed behind. A rushed behind occurs when the ball passes through the goalposts and was last touched by a defending player.

Are lineups and player data available for both Men's and Women's competitions?

No. Player data is currently only available for the Men's competition.

Event Types

What are the possible event types logged?

  • match_started
  • period_start
  • score_change
  • break_start
  • period_score
  • match_ended