Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Lineups

Provides match lineups for a given season.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

30s Time To Live / Cache


Data Points

Category & Sport
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a sport event's category

ex. AUS (Australia)
idsport_event_context - categoryStringUnique category ID for a sport event

ex. sr:category:87
namesport_event_context - categoryStringName for a sport event's category

ex. Australia
idsport_event_context - sportStringUnique sport ID for a sport event

ex. sr:sport:13
namesport_event_context - sportStringName for a sport event's sport

ex. Aussie Rules
Competition
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition

men, women
idsport_event_context - competitionStringUnique ID for a competition

ex. sr:competition:656 (AFL)
namesport_event_context - competitionStringName of a competition

ex. AFL, AFL, Women
Groups
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group

ex. sr:league:80118 (AFL 2024)
namesport_event_context - groups - groupStringName of a sport event's group

ex. AFL 2024, AFL 2024, Final Series
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group

ex. D
Rounds
AttributeParent ElementTypeDescription
competition_sport_event_numbersport_event_context - roundIntegerSport event number within a competition. Used for competitions that have fixed match numbers.
cup_round_idsport_event_context - roundStringUnique ID for a sport event's cup round

ex. sr:cup_round:1934530
cup_round_number_of_sport_eventssport_event_context - roundIntegerNumber of events in a sport event's round
cup_round_sport_event_numbersport_event_context - roundIntegerNumber within the cup_round of a match ID. For example, 1st leg of 2
namesport_event_context - roundStringName of a sport event's round

ex. grand_finals or preliminary_finals
numbersport_event_context - roundIntegerNumber of a sport event's round
other_sport_event_idsport_event_context - roundStringA linked sport event ID, typically in a two-legged tie

ex. sr:sport_event:47395897
Seasons
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a sport event belongs to

ex. sr:competition:656 (AFL)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a sport event's season

ex. 2024-09-28
idsport_event_context - seasonStringUnique ID for a sport event's season

ex. sr:season:111244 (AFL 2024)
namesport_event_context - seasonStringName of a sport event's season

ex. Liga ACB 23/24
start_datesport_event_context - seasonDateStart date of a sport event's season

ex. 2024-03-07
yearsport_event_context - seasonStringYear of a sport event's season

ex. 2024
Stages
AttributeParent ElementTypeDescription
end_datesport_event_context - stageDateEnd date of a sport event's stage

ex. 2024-09-28
ordersport_event_context - stageIntegerOrder of a stage within a season
phasesport_event_context - stageStringName of a sport event's stage

ex. final_phase, knockout_stage, playoffs

See the enum_phase entry in our Aussie Rules OpenAPI spec for a complete list of valid phase enum values
start_datesport_event_context - stageDateStart date of a sport event's stage

ex. 2024-09-05
typesport_event_context - stageStringType of a sport event's stage

cup, league
yearsport_event_context - stageStringYear of a sport event's stage

ex. 2024
Competitor
AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name

ex. BRI (Brisbane Lions)
age_groupcompetitors - competitorStringAge group of a competitor, when applicable

ex. U23
countrycompetitors - competitorStringCountry of a competitor

ex. Australia
country_codecompetitors - competitorStringCountry code of a competitor

ex. AUS (Australia)
gendercompetitors - competitorStringGender for a competitor

male, female
idcompetitors - competitorStringUnique ID for a competitor

ex. sr:competitor:4444 (Brisbane Lions)
namecompetitors - competitorStringName for a competitor

ex. Brisbane Lions
qualifiercompetitors - competitorStringDesignation of a competitor for a sport event

home, away
virtualcompetitors - competitorBooleanSignifies a competitor is a virtual team when true. Used for placeholder teams in TBD vs TBD matchups.
Player
AttributeParent ElementTypeDescription
country_codecompetitor - playerStringCountry code of a player

ex. AUS (Australia)
date_of_birthcompetitor - playerDateDate of birth of a player

ex. 1993-05-24
heightcompetitor - playerIntegerHeight of a player in centimeters

ex. 177
idcompetitor - playerStringUnique ID of a player

ex. sr:player:509236
jersey_numbercompetitor - playerIntegerJersey number of a player
namecompetitor - playerStringName of a player

ex. Neale, Lachie
nationalitycompetitor - playerStringNationality of a player

ex. Australia
nicknamecompetitor - playerStringNickname of a player
playedplayerBooleanSignifies a player appeared in a game when true

We do not currently differentiate between starter and played in the API.
typecompetitor - playerStringPosition of a player

D, M, F, UF, G
starterplayerBooleanSignifies a player is in the starting lineup of a match when true

We do not currently differentiate between starter and played in the API.
weightcompetitor - playerIntegerWeight of a player in kilograms

ex. 82
Sport Event
AttributeParent ElementTypeDescription
idsport_eventStringUnique ID of a sport event

ex. sr:sport_event:53800561
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date

ex. sr:sport_event:47395897
resume_timesport_eventDateAn updated timestamp if there is a delay at the start or interruption during a match

ex. 2024-03-26T20:00:00+00:00
start_timesport_eventDateStart time of a sport event

ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a sport event is confirmed when true
Sport Event - Coverage Properties
AttributeParent ElementTypeDescription
typesport_event - coverageStringType of coverage

sport_event, group, competition
basic_play_by_playsport_event - coverage - sport_event_propertiesBooleanSignifies basic play-by-play is available for a sport event when true
basic_player_statssport_event - coverage - sport_event_propertiesBooleanSignifies basic player stats is available for a sport event when true
basic_team_statssport_event - coverage - sport_event_propertiesBooleanSignifies basic team stats is available for a sport event when true
goal_scorerssport_event - coverage - sport_event_propertiesBooleanSignifies goal scorers are available for a sport event when true
lineupssport_event - coverage - sport_event_propertiesBooleanSignifies lineups are available for a sport event when true
scoressport_event - coverage - sport_event_propertiesStringDescribes the availability of scores as live or post-match

live, post
Period Scores
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway team period score
away_display_scoresport_event_status - period_scores - period_scoreStringAway team period display score ('Number of Goals'.'Number of Points'.'Total')

ex. 5.5.35
home_scoresport_event_status - period_scores - period_scoreIntegerHome team period score
home_display_scoresport_event_status - period_scores - period_scoreStringHome team period display score ('Number of Goals'.'Number of Points'.'Total')

ex. 5.5.35
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod type

regular_period, overtime, 1st_period, 2nd_period, 3rd_period, 4th_period, 1st_pause, 2nd_pause, 3rd_pause, interrupted
Sport Event Status
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away team in the match
away_display_scoresport_event_statusIntegerDisplay score for the away team in the match ('Number of Goals'.'Number of Points'.'Total')

ex. 18.12.120
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time
home_scoresport_event_statusIntegerTotal score for the home team in the match
home_display_scoresport_event_statusIntegerDisplay score for the home team in the match ('Number of Goals'.'Number of Points'.'Total')

ex. 9.6.60
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time
match_statussport_event_statusStringStatus within a match (sport event). Provides more detail on the state of a sport event when live than status

ex. not_started, 1st_quarter, ended, cancelled

See our FAQ for a complete list of statuses and their definitions.
match_tiesport_event_statusBooleanSignifies a match ended in a tie when true
scount_abandonedsport_event_statusBooleanSignifies a sport event was abandoned by a scout when true
statussport_event_statusStringStatus of a sport event

ex. not_started, live, ended, closed

See our FAQ for a complete list of statuses and their definitions.
winner_idsport_event_statusStringUnique ID of the match winner

ex. sr:competitor:4444
Venue
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of venue

ex. 42000
changedvenueBooleanSignifies a venue has been changed when true
city_idvenueStringUnique ID of a city

ex. sr:city:59
city_namevenueStringCity name of venue

ex. Brisbane
country_codevenueStringCountry code of venue

ex. AUS (Australia)
country_namevenueStringCountry name of venue

ex. Australia
idvenueStringUnique ID of venue

ex. sr:venue:7698
map_coordinatesvenueStringCoordinates of venue

ex. -27.485833,153.038056
namevenueStringName of venue

ex. The Gabba
reduced_capacityvenueBooleanOptional attribute signifying a venue has a restricted capacity when true
reduced_capacity_maxvenueIntegerValue of a venue's restricted capacity
timezonevenueStringTimezone of venue

ex. Australia/Queensland
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
required
Defaults to en

2-letter code for supported languages

en (English)

English is the only fully supported language for this API. Click here for valid language codes and a tabular list of available languages per competition.

string
required
Defaults to sr:season:124719

Unique Id of a season, found in the Seasons endpoint

Note: The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.

Example: sr:season:124719

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Query Params
int32

The number of items to skip before starting to collect the result set.
Default: 0

Example: start=200

Note: You may alternatively use offset

int32

The number of items to return.
Maximum: 200
Default value: 200

Example: limit=5

Note: Pagination may be required to pull all data within this feed. By default, the feed will return 200 sport events.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json