SportsML Documentation

Version:1.5
Creator:IPTC

Description

SportsML is a global XML standard for the interchange of sports data. Designed to be as easy to understand and implement as possible, SportsML allows for the exchange of sports scores, schedules, standings, and statistics for a wide variety of competitions. Its extensibility allows for the easy accommodation of many sports from around the globe. It cooperates with current IPTC standards NewsML and NITF to enable publishers to package sports statistics alongside edited coverage of sports.

sports-content

Metadata and coverage of sporting news. | Good for scores, schedules, standings, statistics, etc.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

sports-metadata

Metadata for the document being published. | Holds metadata applying to the document as a whole.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
class An open placeholder for categorization.
string
style An open placeholder for reference by an external stylesheet.
string
doc-id The often-unique ID of the document, tracked by publishers.
string
publisher Publisher of the data.
string
date-time Date-timestamp for the document, normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD when no time is available
dateTime.Common
language The default language of the document. May be overridden via xml:lang. In ISO format - example: en-US.
string
slug A keyword used by editors to refer to the document.
string
document-class A category code for the fixture-key. Equals news, standings, schedules, statistics, event-summary, event-action, dynamic-resource-file
string
fixture-key A consistent key for the type of regularly-published document being transmitted. External controlled vocabulary: fixture-key.list
string
fixture-source The maintainer of the controlled-vocabulary of fixture-keys.
string
fixture-name A displayable name for the fixture-key.
string
feature-name A publisher-created subset of the fixture-key.
string

catalog

A reference to the document listing externally-supplied controlled vocabularies. | The catalog file is in NewsML.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
href The URL for the catalog.
string

sports-title

A short textual description of the document. | Can show up in search results.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

advisory

A short textual message to editors receiving the document. | Not generally published through to end-users.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

sports-content-codes

A container for content-codes. | Can hold as many codes as needed to describe all contents at this level and below.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

sports-content-code

An individual code that describes an entity one may want to filter for. | Describes what sports, what teams, etc., are covered.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
code-type What type of item is being described.
codeType.Core
code-key The symbol for the identified content.
string
code-source The maintainer of the controlled vocabulary for the code.
string
code-name A displayable name for the code.
string

sports-content-qualifier

Further refinement/elaboration of a sports-content-code. | If the document covers more than one of these, additional sports-content-qualifier elements may be used.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
gender One specific gender or mixed.
gender.Core
participant-count Number of participants playing on a team or side in the events covered.
participantCount.Core
professional-status The professional-status of the events covered.
professionalStatus.Core
special-group If the events covered are for special groups. Can be school-oriented, age-oriented, or group names, like Firefighters.
specialGroup.Core
minimum-age Lowest age for participants, in years. Examples: 0, 14, 21.5.
string
maximum-age Highest age for participants, in years. Examples: 8, 65, 120.
string
special-needs Events for persons with special-needs.
specialNeeds.Core

sports-property

An extensible property. | Like in NewsML.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
formal-name The code or key for the property.
string
vocabulary Provides a pointer to a Topic Set which is the controlled vocabulary that can be used to resolve the meaning of the formal-name.
string
scheme Distinguishes which of possibly multiple naming schemes in the controlled vocabulary is the one that governs this formal-name.
string
value The value of the property. For example, if formal-name equals favorite-color, then value might equal blue.
string
allowed-values Points to a controlled vocabulary that delimits the set of allowed values for the property.
string

article

Holds either an article or a reference to an article. | Recommended format is NITF.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
class An open placeholder for categorization.
string
style An open placeholder for reference by an external stylesheet.
string
format Format for the included content.
string
article-ref URL or system identifier (or IDREF?) to an externally-located news article.
string

sports-event

A sporting competition. | A contest that generally ends with a winner.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

event-metadata

Background information about a game. | Where, when, and what an event is.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
event-key The symbol for the identified sports-event.
string
event-source The maintainer of the controlled vocabulary for the key.
string
event-name A displayable name for the key.
string
event-style Indicates whether competitors are trying to defeat each other or just outdo one another.
eventStyle.Core
event-number The ranked position this event had among other events.
string
event-status The stage of the event, describing whether it has started, is in progress, etc.
eventStatus.Core
postponement-status Either none, weather-delay, or other.
postponementStatus.Core
postponement-note A displayable notice as to why an event was postponed.
string
start-date-time Time the game starts, normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string
start-weekday Day of the week in which the game starts.
end-date-time Time the game ends, normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string
end-weekday Day of the week in which the game ends.
heat-number The ranked position this heat had among other heats.
string
duration The length of time the event took place.
duration.Common

event-sponsor

A sponsor for an event. | Events can have more than one sponsor.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
type Could be main, supporting, etc.
string
name The name of the sponsor.
string

site

An element housing data having to do with a venue, stadium, arena, field, etc.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

site-metadata

Metadata about the site.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
site-key The unique identifier for the site.
string
site-source The maintainer of the controlled vocabulary for the site-key.
string
capacity How many spectators can fill the site.
string
style Whether it is an indoor or outdoor site
string
surface Describes the surface upon which events are played. For example, in tennis, could be hard-court or grass or clay.
string
home-page-url The website for the venue or arena.
string

site-stats

Holder for statistics about the site.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
alignment Statistics about the site, accurate for a particular occasion.
attendance How many spectators attended during the event.
string
attendance-average Average number of spectators that have attended.
string
temperature Temperature of the event recorded during the competition.
string
temperature-units Units of the temperature value.
string
weather-code A controlled-vocabulary description of the weather, such as sunny, partly-cloudy, etc.
string
weather-label Additional comment about the weather.
string
weather-wind Wind reading of the event recorded during the competition.
string

team

A team participating in a sporting event. | Holds code and names for team.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

team-metadata

Info about the team. Properties of a team that are not based on their competitive performance. | An included sports-content-code element can hold what division it is in, etc.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
team-key A unique identifier for the team.
teamKey.Common
team-source The maintainer of the controlled vocabulary for the team-key. A reference to the catalog file, which holds the URL for the topic set in which the team-key is listed.
string
alignment Home or visiting.
team-idref Optional reference to a team in which this team is a member. Example: The U.S. Davis Cup team consists of many sub-teams.
IDREF
home-page-url The fully-qualified URL for the official home page of the team.
string

home-location

A location. | Could be the hometown of a person, or where a team usually plays.

Attributes

NameDescription
Type (Declaration)
city The city.
string
county The county.
string
state The state or province.
string
country The country. Generally, an ISO two-letter country-code.
string

team-stats

Statistics that apply to the team as a whole. | Not all stats are used in every sport.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
score Final or current score of the team or player.
string
score-opposing Final or current score of the opposing team or player.
string
score-average Average per-game score for the team or player.
string
score-opposing-average Average per-game score for the opposing team or player.
string
score-units Describes how the score and score-opposing is valued.
scoreUnits.Core
score-attempts Final or current number of attempts to score by a team or player. Example: in ice hockey, would represent total shots on goal.
string
score-attempts-opposing Final or current number of attempts to score by an opposing team or player.
string
score-attempts-on-goal A subset of score-attempts. Only counts those attempts that were on-goal.
string
score-attempts-on-goal-opposing Final or current number of attempts to score by an opposing team or player that were on-goal.
string
score-percentage Percentage of attempted scores that reached their mark.
string
score-percentage-opposing Percentage of attempted scores by opposing team or player that reached their mark.
string
result-effect Describes the effect that the result of the event or rank changing has had on the team. Example: Whether or not a team has qualified for the playoffs, or has been promoted or demoted to a different division.
resultEffect.Core
event-outcome Whether the competitor won, lost, or tied.
event-standing-points How many new points were earned as a result of the outcome of this particular event.
string
event-odds The odds that this team or player would win the event. Candidate for deprecation.
string
events-played The number of sports-events in which this team has already participated.
string
standing-points A quantity used to rank teams, usually within a division, in order to decide who comes in first at the end of a season.
string
games-back A number used to measure how behind one team is from first place. The first place team is 0 games back.
string
streak A value used to say how many events in a row the team has most recently won or lost. Deprecated. Use outcome-totals instead.
string

sub-score

Statistics that detail the score for a particular period or inning. | Per-sport controlled vocabularies used for period-value.

Attributes

NameDescription
Type (Declaration)
period-value Could be quarter-1, period-2, inning-5, etc.
string
score The score for that period.
string

sub-score-attempts

Statistics that detail the scoring attempts for a particular period or inning. | Per-sport controlled vocabularies used for period-value.

Attributes

NameDescription
Type (Declaration)
period-value Could be quarter-1, period-2, inning-5, etc.
string
score-attempts The score for that period.
string

penalty-stats

Statistics that detail the number of each type of penalty. | Can be recorded for either a team or a player.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
type Could be a numeric value like 2, 5 or 10 for ice hockey, or yellow-card or red-card for soccer etc.
string
count The number of that type of penalities for this team or player.
string

outcome-totals

A report on the number of wins, losses, etc., the team or player had during a particular time period. | Can also be scoped with various coverage qualifications, such as just events played at home.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
wins Number of wins.
string
losses Number of losses.
string
ties Number of ties.
string
undecideds Number of events that were started, but ended up undecided.
string
winning-percentage The winning percentage. Generally, wins divided by total events completed.
string
points-scored-for The number of points a team has scored against its opponents during an extended time period.
string
points-scored-against The number of points scored against a team by its opponents during an extended time period.
string
points-difference The final calculated difference between points-scored-for and points-scored-against. Possibly takes into account other scoring aspects, such as penalties and differences in score-values.
string
standing-points A quantity used to rank teams, usually within a division, in order to decide who comes in first at the end of a season. Localized to the coverage-attributes.
string
streak-type Whether this is a streak of wins, of losses, etc.
streak-duration How long the streak lasted.
duration.Common
streak-total Holds the number of goals scored during a streak-type of score, for example.
string
streak-start Date on which the streak began.
dateTime.Common
streak-end Date on which the streak ended.
dateTime.Common

event-record

A world, national, state, or school record. | More than one record can be set by one participant at one sports-event.

Attributes

NameDescription
Type (Declaration)
type The type or record.
string
previous-record The score value of the previously-held record.
string

rank

How a team is doing in comparison to other teams or players. | May be qualified, so that one ranks teams or players according to, say, how they play at home, or within their division.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
value The value of the rank.
string
value-previous The previous rank.
string

rating

A judged value placed on the team or individual. | Often used in British soccer.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
rating-type A classification for the rating.
string
rating-value The value of the rating.
string
rating-maximum The maximum value for the rating.
string

wagering-stats

An element to house lines and odds for wagering. | Includes moneylines, spreads, etc.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
comment A generic comment for the wagering stats.
string

wagering-moneyline

Odds in terms of money. | Negative amount indicates wagerer must lay that amount to win say a hundred dollars. Positive amount indicates wagerer gets that amount for every hundred dollars wagered.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
bookmaker-key Unique ID for the make of the line.
string
bookmaker-name Name of the maker of the line.
string
rotation-key Reusable ID for the team generally agreed upon by a pool of bookmakers.
string
comment A comment for this line. Often the same comment is supplied for both teams in a game.
string
date-time The date and time which this wagering info was assigned by the bookmaker.
string
context An indication of whether this line is a current line, or a repeat of a special-interest line from the past.
prediction Whether this team or player is the favorite or the underdog.
line The actual line value.
string
prediction-opening The opening value for this prediction.
line-opening The opening value for this line.
string
vigorish The commission paid to the bookmaker.
string

wagering-total-score

Total combined point/runs/goals scored in a game.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
bookmaker-key Unique ID for the make of the line.
string
bookmaker-name Name of the maker of the line.
string
rotation-key Reusable ID for the team generally agreed upon by a pool of bookmakers.
string
comment A comment for this line. Often the same comment is supplied for both teams in a game.
string
date-time The date and time which this wagering info was assigned by the bookmaker.
string
context An indication of whether this line is a current line, or a repeat of a special-interest line from the past.
prediction Whether this team or player is the favorite or the underdog.
line-over The OVER section of an over/under line.
string
line-under The UNDER section of an over/under line.
string
total The combined total of the score for the two teams.
string
prediction-opening The opening value for this prediction.
line-over-opening The opening value of the OVER section of an over/under line.
string
line-under-opening The opening value of the UNDER section of an over/under line.
string
total-opening The opening value of the combined score for the two teams.
string
vigorish The commission paid to the bookmaker.
string

wagering-runline

A line used in baseball.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
bookmaker-key Unique ID for the make of the line.
string
bookmaker-name Name of the maker of the line.
string
rotation-key Reusable ID for the team generally agreed upon by a pool of bookmakers.
string
comment A comment for this line. Often the same comment is supplied for both teams in a game.
string
date-time The date and time which this wagering info was assigned by the bookmaker.
string
context An indication of whether this line is a current line, or a repeat of a special-interest line from the past.
line The value of the runline.
string
value Generally +1.5 or -1.5.
string
prediction Whether this team or player is the favorite or the underdog.
line-opening The opening line for this runline.
string
value-opening The opening value for this runline.
string
prediction-opening The opening value for this prediction.
vigorish The commission paid to the bookmaker.
string

wagering-odds

A line that gives formal odds on a team or player winning, such as 3-to-1 odds.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
bookmaker-key Unique ID for the make of the line.
string
bookmaker-name Name of the maker of the line.
string
rotation-key Reusable ID for the team generally agreed upon by a pool of bookmakers.
string
comment A comment for this line. Often the same comment is supplied for both teams in a game.
string
date-time The date and time which this wagering info was assigned by the bookmaker.
string
context An indication of whether this line is a current line, or a repeat of a special-interest line from the past.
numerator The numerator of the chances this team or player is given.
string
denominator The denominator of the chances this team or player is given.
string
numerator-opening The opening value of the numerator.
string
denominator-opening The opening value of the denominator.
string
payout-calcluation How much money additional gets paid should this team or player or team win.
string
payback-amount The total amount paid back to the winning wagerer, including the amount invested.
string

wagering-prediction

A prediction as to whether a team or player is a favorite or an underdog.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
prediction Whether this team or player is the favorite or the underdog.

wagering-straight-spread

A wager built around the different between the scores of two teams.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
bookmaker-key Unique ID for the make of the line.
string
bookmaker-name Name of the maker of the line.
string
rotation-key Reusable ID for the team generally agreed upon by a pool of bookmakers.
string
comment A comment for this line. Often the same comment is supplied for both teams in a game.
string
date-time The date and time which this wagering info was assigned by the bookmaker.
string
context An indication of whether this line is a current line, or a repeat of a special-interest line from the past.
prediction Whether this team or player is the favorite or the underdog.
value The number of points for which the two scores should differ.
string
prediction-opening The opening value for this prediction.
value-opening The opening value.
string
vigorish The commission paid to the bookmaker.
string

affiliation

A mechanism for assigning the membership of a player or team within a division or larger organizational structure.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
membership-idref A pointer to the ID for the larger organizational structure.
string
membership-type The type of organizational structure in which this item is a member.
string
membership-key A unique key for the organizational structure in which this item is a member.
string
membership-name The name associated with the organizational structure in which this item is a member.
string

player

A competitor. | Their athletic talents help them decide who wins a sports-event.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

player-metadata

Metadata that describes a player. | Generally does not change over the course of a sports-events.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
player-key The symbol for the player.
string
player-source The maintainer of the controlled vocabulary for the key.
string
team-idref A reference to the team for which this player competes.
string
team-key A key-based reference to the team for which this player competes.
string
status Whether a player starts playing at the beginning of a sports-event, joins mid-game, or is not available to participate.
status.Core
date-of-birth The day on which a player was born, normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string
height Height of the player. Generally in cm.
string
weight Weight of a player. Generally in kg.
string
position-regular The code for the typical position at which this player plays.
position.Common
position-event The code for the position played by the player at this particular sports-event.
position.Common
position-depth A ranking amongst players on the team who share the same position.
string
position-source The source of the controlled-vocabulary for position-regular and position-event.
string
health An indication of the health of the player.
health.Core
uniform-number The number currently displayed on the uniform or jersey of the player.
string
home-page-url The fully-qualified URL for the official home page of the team.
string
gender Male or female.
nationality Your country of citizinship.
string

career-phase

A description of where a player is playing, or has previously played. | Can be used to state where the player went to college. Can also list previous teams of the player.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
phase-type Value can be college or professional, etc.
phaseType.Core
name Name of the team or college, for example.
string
start-date When the player started this phase in the career, generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string
end-date When the player ended this phase in the career, generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string
duration In lieu of a start-date and end-date. Generally in years. Could hold the number of years that a player was a pro.
duration.Common

name

Name of a player, official, associate, team, etc. | Sometimes a person is referred-to by different names, depending upon the language in which the document is displayed.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
full The entire name.
string
first The first name refered to. For people, should be the given name. Also, if person has only one name, like Pele or Ronaldo, use this one.
string
middle The middle name refered to.
string
last The last name referred to. For people, should be the surname.
string
nickname A nickname ascribed to the person or team.
string
language A language code in which it is appropriate to display this name.
string

player-stats

Statistics that capture how a player has performed. | Generally does change over the course of a sports-event.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
score Final or current score of the team or player.
string
score-opposing Final or current score of the opposing team or player.
string
score-average Average per-game score for the team or player.
string
score-opposing-average Average per-game score for the opposing team or player.
string
score-units Describes how the score and score-opposing is valued.
scoreUnits.Core
score-attempts Final or current number of attempts to score by a team or player. Example: in ice hockey, would represent total shots on goal.
string
score-attempts-opposing Final or current number of attempts to score by an opposing team or player.
string
score-attempts-on-goal A subset of score-attempts. Only counts those attempts that were on-goal.
string
score-attempts-on-goal-opposing Final or current number of attempts to score by an opposing team or player that were on-goal.
string
score-percentage Percentage of attempted scores that reached their mark.
string
score-percentage-opposing Percentage of attempted scores by opposing team or player that reached their mark.
string
result-effect Describes the effect that the result of the event or rank changing has had on the team. Example: Whether or not a team has qualified for the playoffs, or has been promoted or demoted to a different division.
resultEffect.Core
event-outcome Whether the competitor won, lost, or tied.
event-standing-points How many new points were earned as a result of the outcome of this particular event.
string
event-odds The odds that this team or player would win the event. Candidate for deprecation.
string
time-played-event Value for the amount of time played by this player in a particular sports-event.
string
time-played-total Value for the amount of time played by the player over the course particular time-span, such as a season.
string
events-played Number of sports-events the player has participated in.
string
events-started Number of sports-events the player has played in since the start of the event.
string

associate

Manager or coach or jockey, etc. | An individual or a group that assists a team or player, and functions in a supporting capacity.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

associate-metadata

Metadata that describes an associate | Generally does not change over the course of a sports-events.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
associate-key The symbol for the associate.
string
associate-source The maintainer of the controlled vocabulary for the key.
string
position A displayable name for the key.
string
position-source The source of the controlled-vocabulary for position.
string

associate-stats

Statistics that capture values about the participation of an associate during one or more sports-events. | Generally does change over the course of a sports-event.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

officials

A set of officials. | May hold zero or more.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

official

Also referred to as umpire or referree. | Ensures that the sports-event is played according to its rules.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

official-metadata

Metadata about the official. | Generally does not change over the course of a sports-events.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
official-key The symbol or identifying key for the official.
string
official-source The maintainer of the controlled vocabulary for the key.
string
position A code for the position of the official.
string
position-source The source of the controlled-vocabulary for position.
string

official-stats

Statistics about the official. | Generally does change over the course of a sports-events..

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

tournament

A structured series of competitions within one sport. | Generally organized by a particular sponsoring body. Can happen all in one day, or be spread out - like the Davis Cup in tennis.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

tournament-metadata

Background data about a tournament. | Where and when the this tournament took place.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
site-key The symbol for the site at which the event is played. Deprecated in favor of site element.
string
site-source The maintainer of the controlled vocabulary for the key. Deprecated in favor of site element.
string
site-name A displayable name for the key. Deprecated in favor of site element.
string
site-capacity How many spectators can fill the site. Deprecated in favor of site element.
string
site-style Whether it is an indoor or outdoor site. Deprecated in favor of site element.
siteStyle.Core
site-surface Describes the surface upon which events are played. For example, in tennis, could be hard-court or grass or clay. Deprecated in favor of site element.
siteSurface.Core
site-city City in which the site is located. Deprecated in favor of site element.
string
site-county County in which the site is located. Deprecated in favor of site element.
string
site-state State or province in which the site is located. Deprecated in favor of site element.
string
site-country Country in which the site is located. Generally, a two-letter ISO code. Deprecated in favor of site element.
string
site-alignment Whether the site is neutral with respect to the competitors, or is the often-used site of the home team. Deprecated in favor of site element.
site-attendance How many spectators attended during the event. Deprecated in favor of site element.
string
site-temperature Temperature of the event recorded during the competition. Deprecated in favor of site element.
string
site-temperature-units Units of the temperature value. Deprecated in favor of site element.
string
site-weather-wind Wind reading of the event recorded during the competition. Deprecated in favor of site element.
string
site-weather-label Additional comment about the weather. Deprecated in favor of site element.
string
tournament-key The symbol or identifying key for the tournament.
string
tournament-source The maintainer of the controlled vocabulary for the key.
string
tournament-name A displayable name for the key.
string
start-date-time Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string
end-date-time Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string

tournament-division

A tournament subcategory, often with its own trophy and prize. | Like Mens 30k Nordic Skiing, Womens Doubles.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

tournament-division-metadata

General information about the division of this tournament. | Where and when this division is competing.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
site-key The symbol for the site at which the event is played. Deprecated in favor of site element.
string
site-source The maintainer of the controlled vocabulary for the key. Deprecated in favor of site element.
string
site-name A displayable name for the key. Deprecated in favor of site element.
string
site-capacity How many spectators can fill the site. Deprecated in favor of site element.
string
site-style Whether it is an indoor or outdoor site. Deprecated in favor of site element.
siteStyle.Core
site-surface Describes the surface upon which events are played. For example, in tennis, could be hard-court or grass or clay. Deprecated in favor of site element.
siteSurface.Core
site-city City in which the site is located. Deprecated in favor of site element.
string
site-county County in which the site is located. Deprecated in favor of site element.
string
site-state State or province in which the site is located. Deprecated in favor of site element.
string
site-country Country in which the site is located. Generally, a two-letter ISO code. Deprecated in favor of site element.
string
site-alignment Whether the site is neutral with respect to the competitors, or is the often-used site of the home team. Deprecated in favor of site element.
site-attendance How many spectators attended during the event. Deprecated in favor of site element.
string
site-temperature Temperature of the event recorded during the competition. Deprecated in favor of site element.
string
site-temperature-units Units of the temperature value. Deprecated in favor of site element.
string
site-weather-wind Wind reading of the event recorded during the competition. Deprecated in favor of site element.
string
site-weather-label Additional comment about the weather. Deprecated in favor of site element.
string
division-key The symbol or identifying key for the division.
string
division-source The maintainer of the controlled vocabulary for the key.
string
division-name A displayable name for the key.
string
start-date-time Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string
end-date-time Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string

tournament-stage

A tournament subcategory. | Used to group rounds, or other stages. Useful for large-scale soccer tournaments, for example.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

tournament-stage-metadata

General information about the stage of this tournament. | Where and when this stage is competing.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
site-key The symbol for the site at which the event is played. Deprecated in favor of site element.
string
site-source The maintainer of the controlled vocabulary for the key. Deprecated in favor of site element.
string
site-name A displayable name for the key. Deprecated in favor of site element.
string
site-capacity How many spectators can fill the site. Deprecated in favor of site element.
string
site-style Whether it is an indoor or outdoor site. Deprecated in favor of site element.
siteStyle.Core
site-surface Describes the surface upon which events are played. For example, in tennis, could be hard-court or grass or clay. Deprecated in favor of site element.
siteSurface.Core
site-city City in which the site is located. Deprecated in favor of site element.
string
site-county County in which the site is located. Deprecated in favor of site element.
string
site-state State or province in which the site is located. Deprecated in favor of site element.
string
site-country Country in which the site is located. Generally, a two-letter ISO code. Deprecated in favor of site element.
string
site-alignment Whether the site is neutral with respect to the competitors, or is the often-used site of the home team. Deprecated in favor of site element.
site-attendance How many spectators attended during the event. Deprecated in favor of site element.
string
site-temperature Temperature of the event recorded during the competition. Deprecated in favor of site element.
string
site-temperature-units Units of the temperature value. Deprecated in favor of site element.
string
site-weather-wind Wind reading of the event recorded during the competition. Deprecated in favor of site element.
string
site-weather-label Additional comment about the weather. Deprecated in favor of site element.
string
stage-key The symbol or identifying key for the stage.
string
stage-source The maintainer of the controlled vocabulary for the key.
string
stage-name A displayable name for the key.
string
start-date-time Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string
end-date-time Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string

tournament-round

Sub-component of tournament-division. | All teams might participate in each round, or only the winners might progress. Not always sequential.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
site-key The symbol for the site at which the event is played. Deprecated in favor of site element.
string
site-source The maintainer of the controlled vocabulary for the key. Deprecated in favor of site element.
string
site-name A displayable name for the key. Deprecated in favor of site element.
string
site-capacity How many spectators can fill the site. Deprecated in favor of site element.
string
site-style Whether it is an indoor or outdoor site. Deprecated in favor of site element.
siteStyle.Core
site-surface Describes the surface upon which events are played. For example, in tennis, could be hard-court or grass or clay. Deprecated in favor of site element.
siteSurface.Core
site-city City in which the site is located. Deprecated in favor of site element.
string
site-county County in which the site is located. Deprecated in favor of site element.
string
site-state State or province in which the site is located. Deprecated in favor of site element.
string
site-country Country in which the site is located. Generally, a two-letter ISO code. Deprecated in favor of site element.
string
site-alignment Whether the site is neutral with respect to the competitors, or is the often-used site of the home team. Deprecated in favor of site element.
site-attendance How many spectators attended during the event. Deprecated in favor of site element.
string
site-temperature Temperature of the event recorded during the competition. Deprecated in favor of site element.
string
site-temperature-units Units of the temperature value. Deprecated in favor of site element.
string
site-weather-wind Wind reading of the event recorded during the competition. Deprecated in favor of site element.
string
site-weather-label Additional comment about the weather. Deprecated in favor of site element.
string
round-key The symbol or identifying key for the round.
string
round-source The maintainer of the controlled vocabulary for the key.
string
round-name A displayable name for the key.
string
round-number The number of the round.
string
start-date-time Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string
end-date-time Generally normalized to ISO 8601: YYYYMMDDTHHMMSS+HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000+HHMM when no time is available.
string

standing

A series of team or individual records. | A series of team or individual records.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
content-label A displayable label describing this standing.
string

standing-metadata

A series of team or individual records. | A series of team or individual records.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string

schedule

A series of games. | Usually grouped by date.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
date-label Displayable label that describes what dates this schedule covers.
string
content-label Displayable label that describes what events this schedule includes.
string

schedule-metadata

Background information about the schedule. | Describes the time period which the schedule covers, and which teams or events may be covered.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string

statistic

A table that generally compares the performance of teams or players. | The fixture-key can identify which regulary-running statistics are being presented.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
type A code describing the class of statistic covered herein, generally part of a controlled vocabulary.
string
content-label A display label for the enclosed statistical ranking.
string

statistic-metadata

Identifies which teams are being covered. | Also indicates the date ranges for which these stats cover.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string

group

A holder for statistics about a particular bracket or division or conference or league. | Holds metadata and stats.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

group-metadata

Metadata about the group.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
group-key A unique ID for the group.
string
group-source The source for the controlled vocabulary for the group-key.
string
group-type The type of group. For example: conference, division, etc.
string
home-page-url The home page URL for the group.
string

group-stats

Statistics that apply to the team as a whole. | Not all stats are used in every sport.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
score Final or current score of the team or player.
string
score-opposing Final or current score of the opposing team or player.
string
score-average Average per-game score for the team or player.
string
score-opposing-average Average per-game score for the opposing team or player.
string
score-units Describes how the score and score-opposing is valued.
scoreUnits.Core
score-attempts Final or current number of attempts to score by a team or player. Example: in ice hockey, would represent total shots on goal.
string
score-attempts-opposing Final or current number of attempts to score by an opposing team or player.
string
score-attempts-on-goal A subset of score-attempts. Only counts those attempts that were on-goal.
string
score-attempts-on-goal-opposing Final or current number of attempts to score by an opposing team or player that were on-goal.
string
score-percentage Percentage of attempted scores that reached their mark.
string
score-percentage-opposing Percentage of attempted scores by opposing team or player that reached their mark.
string
result-effect Describes the effect that the result of the event or rank changing has had on the team. Example: Whether or not a team has qualified for the playoffs, or has been promoted or demoted to a different division.
resultEffect.Core
event-outcome Whether the competitor won, lost, or tied.
event-standing-points How many new points were earned as a result of the outcome of this particular event.
string
event-odds The odds that this team or player would win the event. Candidate for deprecation.
string

status-change

Identifies which teams are being covered. | Also indicates the date ranges for which these stats cover.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
changer-idref A pointer to the player or team that has undergone the status change.
IDREF
status-change-type What type of change was made in the status of a player or team. Examples are injury, trade, cut.
statusChangeType.Core
original-status What the original status of the player or team was. Examples are active, inactive, disabled-list.
string
new-status What the new status of the player or team is. Examples are active, inactive, disabled-list.
string
original-idref Generally, a pointer to the original team that the player in changer-idref was affiliated with.
IDREF
new-idref Generally, a pointer to the new team that the player in changer-idref is now affiliated with.
IDREF

highlight

A textual highlight. | Can hold plain text, or could hold NITF.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
class An open placeholder for categorization.
string
style An open placeholder for reference by an external stylesheet.
string

award

A medal, ribbon, placement, or other type of award. | Can be assigned to an event, a team, or a player.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
class An open placeholder for categorization.
string
style An open placeholder for reference by an external stylesheet.
string
award-type Type of award.
awardType.Core
name Displayable name. For NHL Hockey, could be first-star, second-star, etc.
string
player-or-team-idref Reference to the player or team that received the award.
IDREF
total Total number of these such awards given to the player or team. Can be used to count medals for each country.
string
place The place for which this prize is offered. For example, place=1 means the first-place prize.
string
value The amount of money earned by the player who came in this place.
string
currency The units of currency for the value attribute.
string

event-actions

A container for the various play-by-play actions described herein.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

nitf-placeholder

Not a true SportsML element | Just a placeholder for an NITF document, starting with the element nitf.

event-metadata-american-football

Metadata about the event itself. | Includes the time left, and where the ball is.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods (our shootout periods, for Canadian Football).
string
period-time-elapsed The time elapsed since the beginning of the period.
string
period-time-remaining The time remaining in the period.
string
clock-state Whether the clock is running or stopped.
team-in-possession-idref The ID of the team with the football.
IDREF
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
string
field-side Which side of the field the event is taking place. Either "home" or "visiting".
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
string
week The week during the season in which this game is played.
string

team-metadata-american-football

Metadata about a particular team. | Reserved for future football-specific attributes.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

team-stats-american-football

Statistics about a particular team. | Holds elements that divide statistics into categories.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
yards-per-attempt The average yards gained per play.
string
number-of-plays The number of plays this team has completed, including for offensive, defensive, and special teams.
string
number-of-plays-gaining The number of plays this team has completed for which yards were gained, including for offensive, defensive, and special teams.
string
number-of-plays-losing The number of plays this team has completed for which yards were lost, including for offensive, defensive, and special teams.
string
average-starting-position Average yard-line that the team started on per-drive.
string
timeouts The number of timeouts a team has remaining, either in regulation or in overtime, whichever state the game is currently in.
string
time-of-possession The time during the entire event that a team has possession of the ball.
string
turnover-ratio Derived by subtracting turnovers-giveaways from turnovers-takeaways.
string
time-of-possession-average TBD.
string
time-of-opposition-possession-average TBD.
string

stats-american-football-offensive

Statistics about a particular team or player's offensive performance. | Further breaks down stats into passing, rushing, etc.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
offensive-plays-yards The total yards accumulated through offensive plays.
string
offensive-plays-number The number of offensive plays.
string
offensive-plays-average-yards-per The average number of yards gained per play.
string
offensive-plays-average-yards-per-game The average number of yards gained via offensive plays per game.
string
offensive-rank TBD.
string
possession-duration The average amount of time the team had possession per-drive.
string
possessions-inside-20 TBD.
string
turnovers-giveaway Derived by adding passes-interceptions plus fumbles-own-lost.
string
turnovers-giveaway-average Average-per-game for turnovers-giveaway.
string
handoffs-total TBD.
string
pitches-total TBD.
string

stats-american-football-passing

Statistics about a particular team or player's passing performance. | Used for quarterbacks and receivers.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
passes-attempts The number of passes attempted.
string
passes-completions The number of passes completed successfully.
string
passes-completions-average-per-game TBD.
string
passes-percentage The percentage of all passes that are completed successfully.
string
passes-yards-gross The number of yards gained from passing.
string
passes-yards-net Subtracts out the sacks-against-yards-lost value of stats-american-football-sacks-against element.
string
passes-yards-lost Amount of yards lost due to sacks and completed passing plays that ended behind the line of scrimmage.
string
passes-yards-average TBD.
string
passes-yards-per-attempt TBD.
string
passes-first-down Number of passes a player or team has made for a first-down.
string
passes-touchdowns The number of passes that resulted in touchdowns.
string
passes-touchdowns-percentage The ratio of touchdown passes to attempted passes.
string
passes-interceptions The number of passes that were intercepted.
string
passes-interceptions-percentage The ratio of intercepted passes to attempted passes.
string
passes-interceptions-yards TBD.
string
passes-interceptions-average TBD.
string
passes-interceptions-longest TBD.
string
passes-interceptions-touchdown TBD.
string
passes-longest The yards gained by the single longest completion.
string
passes-average-yards-per The average number of yards gained per attempted pass.
string
passes-average-yards-per-game TBD.
string
passer-rating A complex formula designed to measure quarterback performance.
string
receptions-total The total number of successful passes.
string
receptions-average-per-game TBD.
string
receptions-yards Number of yards a receiver is credited for.
string
receptions-touchdowns Number of receptions a player has caught in or taken to the end-zone.
string
receptions-first-down Number of receptions a player has taken for a first-down.
string
receptions-longest The longest reception a player had, including to the point where they scored, were-tackled, etc.
string
receptions-average-yards TBD.
string
receptions-average-yards-per The average yards per reception.
string
passing-rank TBD.
string
times-thrown-total TBD.
string
receptions-career-100-yard-games TBD.
string
passing-career-300-yard-games TBD.
string

stats-american-football-rushing

Statistics about a particular team or player's rushing performance. | How well they ran with the ball.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
rushes-attempts The number of attempted rushes.
string
rushes-yards The number of yards gained by rushing.
string
rushes-yards-left The number of yards gained by rushing up the left side of the field.
string
rushes-yards-middle The number of yards gained by rushing up the middle of the field.
string
rushes-yards-right The number of yards gained by rushing up the right side of the field.
string
rushes-touchdowns The number of touchdowns resulting from rushing plays.
string
rushing-average-yards-per The average number of yards per rush.
string
rushes-first-down The number of rushes that have resulted in a first-down.
string
rushes-longest The number of yards gained by the single longest rushing play.
string
rushes-average-attempts-per-game TBD.
string
rushes-average-yards-per-game TBD.
string
rushing-rank TBD.
string
rushes-career-100-yard-games TBD.
string

stats-american-football-down-progress

Statistics about a particular team or player's performance on downs. | Covers first downs and conversions.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
first-downs-total The number of first downs achieved.
string
first-downs-pass The number of first downs achieved from passing.
string
first-downs-run The number of first downs achieved from rushing.
string
first-downs-penalty The number of first downs achieved from penalties on the other team.
string
first-downs-yards TBD.
string
first-downs-average-yards-per TBD.
string
conversions-second-down The number of first downs achieved on a second down.
string
conversions-second-down-attempts The number of second downs.
string
conversions-second-down-percentage The percentage of first down attempts on a second down that were successful.
string
conversions-third-down The number of first downs achieved on a third down.
string
conversions-third-down-attempts The number of third downs.
string
conversions-third-down-percentage The percentage of first down attempts on a third down that were successful.
string
conversions-fourth-down The number of first downs achieved on a fourth down.
string
conversions-fourth-down-attempts The number of fourth downs.
string
conversions-fourth-down-percentage The percentage of first down attempts on a fourth down that were successful.
string

stats-american-football-sacks-against

Statistics about the sacks suffered by the offensive team. | How many times and the team was sacked, and for how many yards.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
sacks-against-yards Total number of yards lost by the offense.
string
sacks-against-total Total number of times that the offense was sacked.
string
sacks-against-average TBD.
string
sacks-against-safeties TBD. Number of sacks that resulted in safeties.
string

stats-american-football-defensive

Statistics about a particular player or team's defensive performance. | Covers tackles, interceptions, sacks.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
tackles-total The number of tackles made by the defense.
string
tackles-solo The number of tackles made where only one member of the defense commited the tackle.
string
tackles-assists The number of tackles made where multiple members of the defense commited the tackle.
string
quarterback-hurries An unofficial stat given when a defensive player pressures and hurries the quarterback into making a throw to avoid being sacked.
string
passes-defensed Total number of times a pass was deflected or otherwise defended against.
string
turnovers-takeaway Derived by adding interceptions-total plus fumbles-opposing-recovered.
string
yards-allowed-total TBD.
string
yards-allowed-average TBD.
string
defensive-plays-number TBD.
string
inside-20-plays TBD.
string
inside-20-points-against TBD.
string
inside-20-touchdowns-against TBD.
string
inside-20-touchdowns-against-percentage TBD.
string
defense-rank TBD.
string
defense-rank-pass TBD.
string
defense-rank-rush TBD.
string
interceptions-total Deprecated. The number of passes the defense has intercepted.
string
interceptions-yards Deprecated. The number of yards gained as a result of an interception.
string
interceptions-average Deprecated. The average number of yards gained from interceptions.
string
interceptions-longest Deprecated. The longest interception returned. Greatest number of yards gained on an interception.
string
interceptions-touchdown Deprecated. Numer of interceptions that were run back for a touchdown.
string
sacks-total Deprecated. The number of sacks made by the defense.
string
sacks-yards Deprecated. Number of yards gained by the defense.
string

stats-american-football-scoring

Statistics about a particular team's scoring performance. | For touchdowns, field goals, etc.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
touchdowns-total The number of touchdowns scored by the offense.
string
touchdowns-passing The number of touchdowns scored by passing.
string
touchdowns-rushing The number of touchdowns scored by rushing.
string
touchdowns-special-teams The number of touchdowns scored by special teams.
string
touchdowns-defensive The number of touchdowns scored by the defense.
string
touchdowns-receptions TBD.
string
extra-points-attempts The number of extra points attempted by the offense.
string
extra-points-made The number of extra points made.
string
extra-points-missed The number of extra points missed.
string
extra-points-blocked The number of extra points blocked. Extra points made + blocked does not equal attempts.
string
extra-points-percentage TBD.
string
field-goal-attempts The number of field goals attempted.
string
field-goals-made The number of field goals made.
string
field-goals-missed The number of field goals missed.
string
field-goals-blocked The number of field goald blocked. Note that field-goals-made + field-goals-blocked does not equal field-goals-attempts.
string
field-goal-longest TBD.
string
field-goals-percentage TBD.
string
field-goals-average TBD.
string
safeties-against The number of safeties scored against the offense.
string
two-point-conversions-attempts The number of two point conversions attempted.
string
two-point-conversions-made The number of successful two point conversions.
string
two-point-conversions-made-rushing TBD.
string
two-point-conversions-made-passing TBD.
string
touchbacks-total For Canadian Football. Used to record the number of touchbacks that resulted in scores.
string
single-points TBD. For CFL.
string
inside-20-points TBD.
string
inside-20-touchdowns TBD.
string
inside-20-touchdowns-percentage TBD.
string

stats-american-football-field-goals

Statistics about attempted and made field goals. | Allows for breakdowns between particular yard markers.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
minimum-distance TBD.
string
maximum-distance TBD.
string
attempts TBD.
string
made TBD.
string

stats-american-football-special-teams

Statistics about a particular team's special teams performance. | Covers punts, touchbacks.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
returns-punt-total The number of punts returned.
string
returns-punt-yards The number of yards gained from punt returns.
string
returns-punt-average The average number of yards gained on each punt return.
string
returns-punt-longest The number of yards gained on the longest punt return.
string
returns-punt-touchdown The number of punts returned for a touchdown.
string
returns-punt-against-total TBD.
string
returns-punt-against-yards TBD.
string
returns-punt-against-average TBD.
string
returns-punt-against-longest TBD.
string
returns-punt-against-touchdown TBD.
string
kickoffs-total TBD.
string
kickoffs-adjusted TBD.
string
kickoffs-to-inside-20 TBD.
string
kickoffs-drive-start-against-average TBD.
string
onside-kicks-attempted TBD.
string
onside-kicks-recovered TBD.
string
returns-kickoff-total The number of kickoffs returned.
string
returns-kickoff-yards The number of yards gained from kickoff returns.
string
returns-kickoff-average The average number of yards gained on each kickoff return.
string
returns-kickoff-longest The number of yards gained on the longest kickoff return.
string
returns-kickoff-touchdown The number of kickoffs returned for a touchdown.
string
returns-kickoff-adjusted TBD.
string
returns-kickoff-inside-20 TBD.
string
returns-kickoff-drive-start-average TBD.
string
returns-kickoff-against-total TBD.
string
returns-kickoff-against-yards TBD.
string
returns-kickoff-against-average TBD.
string
returns-kickoff-against-longest TBD.
string
returns-kickoff-against-touchdown TBD.
string
returns-total The total number of returns. Punts + kickoffs.
string
returns-yards The total number of yards gained on punts and kickoffs combined.
string
punts-total The number of punts.
string
punts-yards-gross The sum of the distances of all punts.
string
punts-yards-net The sum of the distances of all punts, minus the distances they were returned.
string
punts-longest The distance of the longest punt.
string
punts-inside-20 The number of punts inside the 20 yard line.
string
punts-inside-20-percentage The percentage of punts inside the 20 yard line.
string
punts-average The average gross punting yardage.
string
punts-average-net TBD.
string
punts-against-total TBD.
string
punts-against-yards-gross TBD.
string
punts-against-yards-net TBD.
string
punts-against-longest TBD.
string
punts-against-inside-20 TBD.
string
punts-against-inside-20-percentage TBD.
string
punts-against-average TBD.
string
punts-against-average-net TBD.
string
punts-blocked The number of punts that were blocked.
string
touchbacks-total The total number of touchbacks, from kickoffs, punts, interceptions, and fumbles.
string
touchbacks-total-percentage The percentage of kickoffs, punts, interceptions, and fumbles which resulted in a touchback.
string
touchbacks-kickoffs The number of kickoffs that went into the end zone and were not brought out.
string
touchbacks-kickoffs-percentage The percentage of kickoffs resulting in touchbacks.
string
touchbacks-punts The number of punts that went into the end zone and were not brought out.
string
touchbacks-punts-percentage The percentage of punts resulting in touchbacks.
string
touchbacks-interceptions The number of interceptions that went into the end zone and were not brought out.
string
touchbacks-interceptions-percentage The percentage of interceptions resulting in touchbacks.
string
touchbacks-punts-against TBD.
string
fair-catches The number of fair catches.
string
fair-catches-against TBD.
string
total-return-yardage-not-kickoffs TBD.
string
touchdowns-against TBD.
string
tackles For Canadian football, records the number of tackles made while playing for a special-team.
string

stats-american-football-fumbles

For tracking fumble stats. | Covers teams that do the fumbling and the recovering.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
fumbles-committed The total number of fumbles.
string
fumbles-forced The number of fumbles that were forced by the opposing team.
string
fumbles-recovered The number of fumbles that were recovered by the fumbling team.
string
fumbles-lost The number of fumbles that were not recovered by the fumbling team.
string
fumbles-lost-average-per-game TBD.
string
fumbles-yards-gained The number of yards gained as a result of fumbles.
string
fumbles-own-committed The number of fumbles committed by this team.
string
fumbles-own-recovered The number of fumbles committed by this team that were then also recovered by this team.
string
fumbles-own-lost The number of fumbles committed by this team but recovered by the other team. A subset of turnovers. Also referred to as a giveaway.
string
fumbles-own-yards-gained The number of yards gained as a result of fumbles by this team.
string
fumbles-own-touchdowns TBD.
string
fumbles-opposing-committed The number of fumbles committed by the opposing team.
string
fumbles-opposing-recovered The number of fumbles committed by the opposing but recovered by this team. A subset of turnovers. Also referred to a takeaway.
string
fumbles-opposing-recovered-average-per-game TBD.
string
fumbles-opposing-lost The number of fumbles committed by the opposing team that were subsequently lost to the opposing team.
string
fumbles-opposing-yards-gained The number of yards gained as a result of fumbles by the opposing team.
string
fumbles-opposing-touchdowns TBD.
string
touchbacks-fumbles The number of fumbles into the end zone that are not brought out.
string
touchbacks-fumbles-percentage The percentage of fumbles that resulted in touchbacks.
string

stats-american-football-penalties

Statistics about penalties. | Applies to both offensive and defensive penalties.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
penalties-total The number of penalties.
string
penalty-yards The yards gained as a result of penalties.
string
penalty-first-downs The number of first downs gained as a result of penalties.
string
penalty-opponent-yards TBD.
string
penalties-opponent-total TBD.
string
penalties-challenged TBD. Includes penalty challenges that were both won and lost.
string
penalties-reviewed TBD. Includes both coach challenges and booth challenges.
string
penalties-overturned TBD.
string

player-metadata-american-football

Player metadata that is specific to football. | Reserved for future use.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

player-stats-american-football

Player statistics for football. | Includes the same elements as team statistics.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

event-actions-american-football

Description of an event. | A play or score should only exist outside a drive for punt-returns or kickoff-returns.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

action-american-football-substitution

A substitution. | Oftentimes recorded for a quarterback change.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods (our shootout periods, for Canadian Football).
string
period-time-elapsed The time elapsed since the beginning of the period.
string
period-time-remaining The time remaining in the period.
string
clock-state Whether the clock is running or stopped.
team-in-possession-idref The ID of the team with the football.
IDREF
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
string
field-side Which side of the field the event is taking place. Either "home" or "visiting".
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
string
player-original-idref The ID of the player going out.
IDREF
player-original-position The position of the player going out.
position.AmericanFootball
player-replacing-idref The ID of the player coming in.
IDREF
player-replacing-position The position of the player coming in.
position.AmericanFootball
substitution-reason The reason for the substitution.
string
comment A comment.
string

action-american-football-play

Only for non-scoring plays. | Holds elements that describe the role each play participant performed.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods (our shootout periods, for Canadian Football).
string
period-time-elapsed The time elapsed since the beginning of the period.
string
period-time-remaining The time remaining in the period.
string
clock-state Whether the clock is running or stopped.
team-in-possession-idref The ID of the team with the football.
IDREF
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
string
field-side Which side of the field the event is taking place. Either "home" or "visiting".
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
string
drive-result Describes how a drive ended, if this play ended a drive.
driveResult.AmericanFootball
score-attempt-type Type of score that was attempted, but missed.
scoreType.AmericanFootball
comment A textual comment.
string
score-team After this action took place, the score of the team that team-idref points to.
string
score-team-opposing After this action took place, the score of the team opposing that listed in team-idref.
string
play-type The type of play. Controlled vocabulary. run | pass | kick | etc.
string

action-american-football-drive

A series of plays that may result in a score. | Ends either in a score, or in a change of possession.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods (our shootout periods, for Canadian Football).
string
period-time-elapsed The time elapsed since the beginning of the period.
string
period-time-remaining The time remaining in the period.
string
clock-state Whether the clock is running or stopped.
team-in-possession-idref The ID of the team with the football.
IDREF
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
string
field-side Which side of the field the event is taking place. Either "home" or "visiting".
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
string
comment A comment.
string
drive-plays The number of plays in this drive.
string
drive-yards The number of yards covered during this drive.
string
drive-duration The time it took for the drive.
string
drive-result TBD.
driveResult.AmericanFootball

action-american-football-score

A play that ended in a score. | Holds participant elements, which detail the role each player had in the scoring play.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods (our shootout periods, for Canadian Football).
string
period-time-elapsed The time elapsed since the beginning of the period.
string
period-time-remaining The time remaining in the period.
string
clock-state Whether the clock is running or stopped.
team-in-possession-idref The ID of the team with the football.
IDREF
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
string
field-side Which side of the field the event is taking place. Either "home" or "visiting".
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
string
team-idref Pointer to the team that scored.
IDREF
score-type TBD.
scoreType.AmericanFootball
points The number of points scored.
string
comment A textual comment.
string
score-team After this action took place, the score of the team that team-idref points to.
string
score-team-opposing After this action took place, the score of the team opposing that listed in team-idref.
string
play-type The type of play. Controlled vocabulary. run | pass | kick | etc.
string

action-american-football-play-participant

Describes which player was involved in the play and how. | The role and result attributes are critical.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods (our shootout periods, for Canadian Football).
string
period-time-elapsed The time elapsed since the beginning of the period.
string
period-time-remaining The time remaining in the period.
string
clock-state Whether the clock is running or stopped.
team-in-possession-idref The ID of the team with the football.
IDREF
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
string
field-side Which side of the field the event is taking place. Either "home" or "visiting".
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
string
comment A comment.
string
player-idref A pointer to the player involved in the play.
IDREF
role Describes how the player got the ball, not what the player did with it.
role.AmericanFootball
result How this segment of the play finished.
result.AmericanFootball
kick-type If result was kick, then the type of kick.
kickType.AmericanFootball
penalty-type What penalty was called on this player. Called while a play is in progress.
penaltyType.AmericanFootball
penalty-acceptance Whether the penalty was accepted or declined.
official-idref Which official called the penalty.
IDREF

action-american-football-penalty

Describes a penalty. Like plays, contains participant elements. | These penalties occur before a play is officially started.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods (our shootout periods, for Canadian Football).
string
period-time-elapsed The time elapsed since the beginning of the period.
string
period-time-remaining The time remaining in the period.
string
clock-state Whether the clock is running or stopped.
team-in-possession-idref The ID of the team with the football.
IDREF
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
string
field-side Which side of the field the event is taking place. Either "home" or "visiting".
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
string
comment A textual comment.
string
recipient-type Whether the receiver of the penalty was the team, the player, a coach, a ref, etc.
recipient-idref A pointer to the receiver of the penalty.
IDREF
caller-idref A pointer to the official who called the penalty.
IDREF
penalty-side Whether a penalty is assessed on the offense or the defense.
penaltySide.AmericanFootball
penalty-level The level of the penalty.
penaltyLevel.AmericanFootball
penalty-yards The number of yards of the penalty.
string
penalty-acceptance Whether the penalty was accepted or declined.
penalty-challenge TBD.
penalty-review TBD.
penalty-review-ruling TBD.

action-american-football-timeout

Describes a timeout. | A break in the action, usually called by one of the teams playing.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods (our shootout periods, for Canadian Football).
string
period-time-elapsed The time elapsed since the beginning of the period.
string
period-time-remaining The time remaining in the period.
string
clock-state Whether the clock is running or stopped.
team-in-possession-idref The ID of the team with the football.
IDREF
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
string
field-side Which side of the field the event is taking place. Either "home" or "visiting".
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
string
comment A textual comment.
string
timeout-type TBD.
timeoutType.AmericanFootball
caller Who called the timeout, either team or official.
caller.AmericanFootball
caller-idref If caller is team, say, a pointer to the team element, or a pointer to a player on the team.
string

action-american-football-other

A custom action. | For use when none of the pre-build actions apply.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods (our shootout periods, for Canadian Football).
string
period-time-elapsed The time elapsed since the beginning of the period.
string
period-time-remaining The time remaining in the period.
string
clock-state Whether the clock is running or stopped.
team-in-possession-idref The ID of the team with the football.
IDREF
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
string
field-side Which side of the field the event is taking place. Either "home" or "visiting".
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
string
action-source The name of the controlled-vocabulary for the action-type attribute.
string
action-type A selection from a controlled-vocabulary list maintained by the publisher.
string
comment Textual comment about the action.
string

event-metadata-baseball

Metadata about the event itself. | Includes what state the game is in.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
inning-value An integer. 1 through 9 for the main innings. 10, 11, 12, etc. for extra innings.
string
inning-half Either top or bottom.
outs Either 1, 2, or 3.
string
balls Either 1, 2, 3, or 4.
string
strikes Either 1, 2, or 3.
string
runner-on-first Whether or not a player is standing on first base. Either true or false.
string
runner-on-first-idref A pointer to the player on first base.
IDREF
runner-on-second Whether or not a player is standing on second base. Either true or false.
string
runner-on-second-idref A pointer to the player on second base.
IDREF
runner-on-third Whether or not a player is standing on third base. Either true or false.
string
runner-on-third-idref A pointer to the player on third base.
IDREF
runs-this-inning-half An integer.
string
pitcher-idref A pointer to the player element for the pitcher standing on the mound.
IDREF
batter-idref A pointer to the player element for the batter at the plate.
IDREF
batter-side Which side of the plate the batter was on when taking the pitch.

team-metadata-baseball

Metadata about the team. | Specific to the sport of baseball.

Attributes

NameDescription
Type (Declaration)
probable-starting-pitcher-idref ID of the pitcher who will probably start the game.
IDREF
id An XML-specific identifier for the element.
ID

team-stats-baseball

Specific statistics for baseball. | Includes offensive, pitching, and defensive stats.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string

stats-baseball-offensive

Stats accumulated while a team is at bat. | Includes hits and runs.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
average Average number of hits per at-bats
string
runs-scored Number of runs scored
string
at-bats Number of at-bats (Does not include walks or Sacrifice Hits)
string
hits Number of hits
string
rbi Number of runs batted in
string
total-bases Calculated by hits + doubles + (triples times 2) + (home-runs times 3).
string
slugging-percentage Total bases divided by at-bats.
string
bases-on-balls Number of times batter was walked
string
bases-on-balls-rate TBD.
string
bases-on-balls-intentional TBD.
string
strikeouts Number of times batter struck out
string
left-on-base Number of runners left on base
string
left-in-scoring-position Number of runners left on second and/or third base
string
singles Number of hits off of which batter advances to first base
string
doubles Number of hits off of which batter advances to second base
string
triples Number of hits off of which batter advances to third base
string
home-runs Number of hits off of which batter advances to home plate
string
grand-slams Number of home runs with bases loaded
string
at-bats-per-rbi RBI per at-bat ratio
string
plate-appearances-per-rbi Plate appearances per at-bat ratio
string
at-bats-per-home-run Home runs per at-bat ratio
string
plate-appearances-per-home-run Plate appearances per home run ratio
string
sac-flies Number of hits resulting in batter out which advance base runner(s)
string
sac-bunts Number of bunts resulting in batter out which advance base runner(s)
string
sacrifices TBD.
string
grounded-into-double-play Number of ground balls which result in batter and base runner outs
string
moved-up Number of times runner advances to another base
string
on-base-percentage Calculated as follows: (hits + bases-on-balls + hit-by-pitch) / (at-bats + bases-on-balls + hit-by-pitch + sac-flies)
string
stolen-bases Number of successfully stolen bases.
string
stolen-bases-caught Number of times the runner was caught while trying to steal bases.
string
stolen-bases-average Success rate for stealing bases.
string
hit-by-pitch Number of times batter hit by pitch
string
defensive-interferance-reaches The number of times the player reached a base due to interference by the defense.
string
on-base-plus-slugging Calculated by adding on-base-percentage to slugging-percentage.
string
plate-appearances Calculated by adding at-bats, bases-on-balls, hit-by-pitch, sac-flies, sac-bunts, and defensive-interfance-reaches.
string
hits-extra-base Calculated by adding doubles, triples, and home-runs.
string
strikeout-rate TBD.
string
shutouts TBD.
string
double-plays-against TBD.
string
triple-plays-against TBD.
string

stats-baseball-pitching

Stats accumulated while a team is pitching. | Includes strikeouts and shutouts.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
runs-allowed Number of runs against
string
home-runs-allowed Number of home runs against
string
innings-pitched Number of innings pitched
string
innings-pitched-average TBD.
string
hits Number of hits against
string
earned-runs Number of earned runs against
string
unearned-runs Number of unearned runs against
string
bases-on-balls Number of earned walks allowed
string
bases-on-balls-intentional Number of batters intentionally walked
string
strikeouts Number of earned strikeouts
string
strikeout-to-bb-ratio Strikeout to walks ratio
string
number-of-pitches Number of pitches thrown
string
number-of-strikes TBD.
string
era Earned run average: Number of earned runs divided by number of innings pitched multiplied by nine
string
whip TBD.
string
inherited-runners-scored Number of runners which a previous pitcher allowed on base which scored
string
pick-offs The number of times the pitcher caught a player trying to steal, before making the pitch.
string
errors-hit-with-pitch Number of times pitcher hits batter with pitch
string
errors-wild-pitch Number of wild pitches thrown
string
balks Number of balks
string
wins Number of games pitcher has won
string
losses Number of games pitcher has lost
string
saves Number of games pitcher has saved
string
saves-blown TBD.
string
saves-tough TBD.
string
saves-opportunities TBD.
string
relief-points Formula for rating relief performances. 4 points for a tough save; 3 points for a save; 2 for a relief win; minus 2 for a relief loss and blown save.
string
shutouts Number of games pitched in which opposing team did not score
string
games-complete Number of complete games pitched
string
games-finished Number of games pitched to the end
string
games-pitched TBD.
string
winning-percentage Calculated by wins divided by (wins + losses).
string
event-credit Whether a pitcher has received credit for winning or losing the game. TBD. Controlled Vocabulary. (win|loss|save|blown-save|win-blown-save|loss-blown-save|hold-win|hold-loss)
save-credit Whether a pitcher has received credit for winning or losing the game. TBD. Controlled Vocabulary. (win|loss|save|blown-save|win-blown-save|loss-blown-save|hold-win|hold-loss)
batters-average-against TBD.
string
batters-at-bats-against TBD.
string
batters-total-bases-against TBD.
string
batters-slugging-percentage-against TBD.
string
batters-on-base-percentage-against TBD.
string
batters-doubles-against TBD.
string
batters-triples-against TBD.
string
batters-home-runs-against TBD.
string

stats-baseball-defensive

Stats accumulated while a team is out in the field. | Includes double-plays and errors.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
position Position played for these stats.
position.Baseball
double-plays Number of times two runners thrown out at the base.
string
triple-plays Number of times three runners thrown out at the base.
string
putouts Number of times a fielder caught a fly ball for an out.
string
assists Number of plays in which a fielder throws a ball to another fielder for the out.
string
errors Number of plays in which a fielder committed an error, such as dropping a ball.
string
fielding-chances TBD.
string
fielding-percentage A measure of fielding success. Calculated as follows: (putouts + assists) / (putouts + assists + errors).
string
defensive-average Rate a fielder turns a bill hit to their area into an out.
string
errors-passed-ball Number of times a catcher is faulted with letting a pitched ball go past.
string
errors-catchers-interference Number of times a catcher has improperly interfered with play.
string
stolen-bases Number of bases successfully stolen while this player was on the field.
string
stolen-bases-caught Number of times a runner was caught while trying to steal bases while this player was on the field.
string
stolen-bases-average Success rate for stealing bases while this player was on the field.
string
innings-played Number of innings played at the named position.
string
games-played Number of games played at the named position.
string

player-metadata-baseball

Metadata about the player. | Specific to the sport of baseball.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
batting-hand Indicates whether player bats left, right, or is a switch-hitter.
throwing-hand Indicates whether player throws left, right, or is a switch-thrower.

player-stats-baseball

Stats collected by a player. | Includes offensive, pitching, and defensive stats.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string

event-actions-baseball

A container for specific baseball actions. | Generally ordered chronologically.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

action-baseball-substitution

An exchange of players occurred. | Most commonly-recorded substitution is a pitching change.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
inning-value An integer. 1 through 9 for the main innings. 10, 11, 12, etc. for extra innings.
string
inning-half Either top or bottom.
outs Either 1, 2, or 3.
string
balls Either 1, 2, 3, or 4.
string
strikes Either 1, 2, or 3.
string
runner-on-first Whether or not a player is standing on first base. Either true or false.
string
runner-on-first-idref A pointer to the player on first base.
IDREF
runner-on-second Whether or not a player is standing on second base. Either true or false.
string
runner-on-second-idref A pointer to the player on second base.
IDREF
runner-on-third Whether or not a player is standing on third base. Either true or false.
string
runner-on-third-idref A pointer to the player on third base.
IDREF
runs-this-inning-half An integer.
string
pitcher-idref A pointer to the player element for the pitcher standing on the mound.
IDREF
batter-idref A pointer to the player element for the batter at the plate.
IDREF
batter-side Which side of the plate the batter was on when taking the pitch.
person-type Whether this substitution was for a player, a coach, an umpire.
person-original-idref A pointer to the person who left the game.
IDREF
person-original-position The position of the original person.
position.Baseball
person-original-lineup-slot The order in the lineup that the player held.
string
person-replacing-idref A pointer to the person who entered the game.
IDREF
person-replacing-position The position of the replacing person.
string
person-replacing-lineup-slot The order in the lineup that the player will hold.
string
substitution-reason Why a substitution was made.
string
comment Textual comment about the action.
string

action-baseball-score

Issued when a run is scored. | Describes which players scored, also.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
inning-value An integer. 1 through 9 for the main innings. 10, 11, 12, etc. for extra innings.
string
inning-half Either top or bottom.
outs Either 1, 2, or 3.
string
balls Either 1, 2, 3, or 4.
string
strikes Either 1, 2, or 3.
string
runner-on-first Whether or not a player is standing on first base. Either true or false.
string
runner-on-first-idref A pointer to the player on first base.
IDREF
runner-on-second Whether or not a player is standing on second base. Either true or false.
string
runner-on-second-idref A pointer to the player on second base.
IDREF
runner-on-third Whether or not a player is standing on third base. Either true or false.
string
runner-on-third-idref A pointer to the player on third base.
IDREF
runs-this-inning-half An integer.
string
pitcher-idref A pointer to the player element for the pitcher standing on the mound.
IDREF
batter-idref A pointer to the player element for the batter at the plate.
IDREF
batter-side Which side of the plate the batter was on when taking the pitch.
play-type A description for the play.
playType.Baseball
play-scorekeepers-notation Denotes which fielders touched the ball during the play. Example: 6-4-3.
string
walk-type If this play was a base-on-balls, the type of walk.
walkType.Baseball
hit-type A description for the hit.
hitType.Baseball
hit-by-pitch-type A description for how or why a batter was hit by a pitch.
hitByPitchType.Baseball
out-type How the out was made.
outType.Baseball
outs-recorded How many outs were recorded on the play. Values are 1, 2, 3.
comment Textual comment about the action.
string
rbi How many runs-batted-in were credited on the play. An error may preclude the assigning of an rbi.
string
runs-scored How many runs scored on the play.
string
score-team The score of the team that did the scoring, once the play completed.
string
score-team-opposing The current score of the team that did not do the scoring.
string

action-baseball-play

Issued when a non-scoring play occurred. | Records a hit, a strikeout, etc.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
inning-value An integer. 1 through 9 for the main innings. 10, 11, 12, etc. for extra innings.
string
inning-half Either top or bottom.
outs Either 1, 2, or 3.
string
balls Either 1, 2, 3, or 4.
string
strikes Either 1, 2, or 3.
string
runner-on-first Whether or not a player is standing on first base. Either true or false.
string
runner-on-first-idref A pointer to the player on first base.
IDREF
runner-on-second Whether or not a player is standing on second base. Either true or false.
string
runner-on-second-idref A pointer to the player on second base.
IDREF
runner-on-third Whether or not a player is standing on third base. Either true or false.
string
runner-on-third-idref A pointer to the player on third base.
IDREF
runs-this-inning-half An integer.
string
pitcher-idref A pointer to the player element for the pitcher standing on the mound.
IDREF
batter-idref A pointer to the player element for the batter at the plate.
IDREF
batter-side Which side of the plate the batter was on when taking the pitch.
play-type A description for the play.
playType.Baseball
play-scorekeepers-notation Denotes which fielders touched the ball during the play. Example: 6-4-3.
string
walk-type If this play was a base-on-balls, the type of walk.
walkType.Baseball
hit-type A description for the hit.
hitType.Baseball
hit-by-pitch-type A description for how or why a batter was hit by a pitch.
hitByPitchType.Baseball
out-type How the out was made.
outType.Baseball
outs-recorded How many outs were recorded on the play. Values are 1, 2, 3.
comment Textual comment about the action.
string

action-baseball-pitch

Issued after a pitch. Not used if the batter hit the ball into play. | Can indicate whether the pitch was a ball or strike, and where the pitch was located.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
inning-value An integer. 1 through 9 for the main innings. 10, 11, 12, etc. for extra innings.
string
inning-half Either top or bottom.
outs Either 1, 2, or 3.
string
balls Either 1, 2, 3, or 4.
string
strikes Either 1, 2, or 3.
string
runner-on-first Whether or not a player is standing on first base. Either true or false.
string
runner-on-first-idref A pointer to the player on first base.
IDREF
runner-on-second Whether or not a player is standing on second base. Either true or false.
string
runner-on-second-idref A pointer to the player on second base.
IDREF
runner-on-third Whether or not a player is standing on third base. Either true or false.
string
runner-on-third-idref A pointer to the player on third base.
IDREF
runs-this-inning-half An integer.
string
pitcher-idref A pointer to the player element for the pitcher standing on the mound.
IDREF
batter-idref A pointer to the player element for the batter at the plate.
IDREF
batter-side Which side of the plate the batter was on when taking the pitch.
pitch-type The net result of the pitch.
strike-type Whether a strike was called by the umpire, or due to swinging.
strikeType.Baseball
ball-location Where with respect to the batter the ball was pitched.
ballLocation.Baseball
comment Textual comment about the action.
string

action-baseball-other

A custom action. | For use when none of the pre-build actions apply.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
inning-value An integer. 1 through 9 for the main innings. 10, 11, 12, etc. for extra innings.
string
inning-half Either top or bottom.
outs Either 1, 2, or 3.
string
balls Either 1, 2, 3, or 4.
string
strikes Either 1, 2, or 3.
string
runner-on-first Whether or not a player is standing on first base. Either true or false.
string
runner-on-first-idref A pointer to the player on first base.
IDREF
runner-on-second Whether or not a player is standing on second base. Either true or false.
string
runner-on-second-idref A pointer to the player on second base.
IDREF
runner-on-third Whether or not a player is standing on third base. Either true or false.
string
runner-on-third-idref A pointer to the player on third base.
IDREF
runs-this-inning-half An integer.
string
pitcher-idref A pointer to the player element for the pitcher standing on the mound.
IDREF
batter-idref A pointer to the player element for the batter at the plate.
IDREF
batter-side Which side of the plate the batter was on when taking the pitch.
action-source The name of the controlled-vocabulary for the action-type attribute.
string
action-type A selection from a controlled-vocabulary list maintained by the publisher.
string
comment Textual comment about the action.
string

event-metadata-basketball

Metadata about the event itself. | Includes what state the game is in.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An integer. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
string
period-time-elapsed The time elapsed in the quarter or overtime period.
string
period-time-remaining The time remaining in the quarter or overtime period.
string

team-metadata-basketball

Metadata about the team. | Specific to the sport of basketball.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

team-stats-basketball

Specific statistics for basketball. | Includes offensive, rebounding, and defensive stats.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
timeouts-left Number of timeouts a team has left during the current event.
string
largest-lead Largest number of points this team has led the opposition. Could be a negative number.
string
fouls-total TBD.
string
average-minutes-per-game TBD.
string
turnover-margin TBD.
string

stats-basketball-offensive

Statistics for a team or player while they had possession of the ball. | Includes scoring and assisting stats.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
field-goals-made Shots made that were worth two points each.
string
field-goals-attempted Two-point shots that were attempted.
string
field-goals-percentage Field goals made versus attempted.
string
field-goals-per-game Average number of field goals made per game.
string
field-goals-attempted-per-game Average number of field goals attempted per game.
string
field-goals-percentage-adjusted A formula measuring shooting efficiency: [(points-scored-total - free-throws-made)/field-goals-attempted]/2.
string
three-pointers-made Shots made that were worth three points each.
string
three-pointers-attempted Three-point shots that were attempted.
string
three-pointers-percentage Three-pointers made versus attempted.
string
three-pointers-per-game Average number of three-pointers made per game.
string
three-pointers-attempted-per-game Average number of three-pointers attempted per game.
string
free-throws-made Shots made that were worth one point each.
string
free-throws-attempted One-point shots that were attempted.
string
free-throws-percentage Free throws made versus attempted.
string
free-throws-per-game Average number of free throws made per game.
string
free-throws-attempted-per-game Average number of free throws attempted per game.
string
points-scored-total Total number of points scored, over the time span indicated in date coverage attributes.
string
points-scored-per-game Average number of points scored in games played during the time span indicated in date coverage attributes.
string
points-scored-per-game-highest TBD.
string
points-scored-per-shot Calculated by dividing points-scored-total by field-goals-attempted.
string
assists-total Total number of assists during the time span indicated in date coverage attributes.
string
assists-per-game Total number of assists per games played during the time span indicated in date coverage attributes.
string
turnovers-total Total number of turnovers during the time span indicated in date coverage attributes.
string
turnovers-per-game Average number of turnovers per game the time span indicated in date coverage attributes.
string
team-turnovers-total Total number of team turnovers during the time span indicated in date coverage attributes.
string
team-turnovers-per-game Average number of team turnovers per game the time span indicated in date coverage attributes.
string
points-scored-off-turnovers Total number of points scored off turnovers the time span indicated in date coverage attributes.
string
points-scored-in-paint Total number of points scored from within the painted area surrounding the basket during the time span indicated in date coverage attributes..
string
points-scored-on-second-chance Total number of points scored after fielding an offensive rebound during the time span indicated in date coverage attributes..
string
points-scored-on-fast-break Total number of points scored off a fast break during the time span indicated in date coverage attributes..
string

stats-basketball-rebounding

Statistics for a team or player revolving around rebounds. | Includes rebounds credited to particular players, and credited to the entire team.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
rebounds-total The sum of all rebounds that were credited to particular players.
string
rebounds-total-percentage TBD.
string
rebounds-defensive The sum of all defensive rebounds credited to particular players.
string
rebounds-defensive-percentage TBD.
string
rebounds-offensive The sum of all offensive rebounds credited to particular player.
string
rebounds-offensive-percentage TBD.
string
team-rebounds-total The number of rebounds that did not credited to individual players, but were instead credited to the team as a whole.
string
team-rebounds-total-percentage TBD.
string
team-rebounds-defensive The sum of all defensive rebounds credited to the team as a whole.
string
team-rebounds-defensive-percentage TBD.
string
team-rebounds-offensive The sum of all offensive rebounds credited to the team as a whol.
string
team-rebounds-offensive-percentage TBD.
string
rebounds-per-game The average number of personal rebounds per event.
string
team-rebounds-per-game The average number of team rebounds per event.
string

stats-basketball-defensive

Statistics for a team or player while the other team was in possession of the ball. | Includes information on steals and blocks.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
steals-total Total number of steals.
string
steals-per-game Average number of steals per game.
string
blocks-total Total number of blocks.
string
blocks-per-game Average number of blocks per game.
string
points-scored-against-per-game TBD.
string
points-scored-against-per-game-highest TBD.
string
field-goals-against-per-game TBD.
string
field-goals-against-percentage TBD.
string
team-turnovers-total TBD.
string

player-metadata-basketball

Metadata about the player. | Specific to the sport of basketball.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

player-stats-basketball

Specific statistics for basketball players. | Includes offensive, rebounding, and defensive stats.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
minutes-played Number of minutes this player has spent playing during a particular game.
string
games-played Number of games played during the time span indicated in date coverage attributes.
string
games-started Number of games that started with this player on the court, during the time span indicated in date coverage attributes.
string
average-minutes-per-game Average number of minutes per game played by this player during the time span indicated in date coverage attributes.
string
personal-fouls-per-game TBD.
string

event-actions-basketball

A container for specific basketball actions. | Generally ordered chronologically.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

action-basketball-substitution

Used when one player comes in for another. | Simultaneous multiple replacements can be handled by using several of these elements, and leaving either the replacing or the original players blank.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An integer. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
string
period-time-elapsed The time elapsed in the quarter or overtime period.
string
period-time-remaining The time remaining in the quarter or overtime period.
string
person-type Whether a player, a coach, or a referree.
person-original-idref A pointer to the player who left the court.
IDREF
person-original-position The position of the player who left the court.
position.Basketball
person-replacing-idref A pointer to the player who now went on the court.
IDREF
person-replacing-position The position of the player who went on the court.
position.Basketball
substitution-reason The reason why a substitution was made.
string
comment A textual comment.
string

action-basketball-score-attempt

Used to record shots that are NOT made. | If the shot was made, use the action-basketball-score.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An integer. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
string
period-time-elapsed The time elapsed in the quarter or overtime period.
string
period-time-remaining The time remaining in the quarter or overtime period.
string
player-idref A pointer to the player who attempted the shot.
IDREF
score-attempt-type What type of shot it was.
scoreAttemptType.Basketball
score-attempt-result TBD.
scoreAttemptResult.Basketball
comment A textual comment.
string

action-basketball-assisting-player

Player who assisted with a score. | Generally, a player who passed the ball to the player who scored.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
player-idref A pointer to a player who assisted in the score.
IDREF

action-basketball-score

Used to record shots that were successful. | Can include update of what the new score is between teams.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An integer. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
string
period-time-elapsed The time elapsed in the quarter or overtime period.
string
period-time-remaining The time remaining in the quarter or overtime period.
string
player-idref A pointer to the player who made the shot.
IDREF
score-attempt-type TBD.
scoreAttemptType.Basketball
points How many points are given for the goal. Generally: 1, 2, or 3.
string
score-team The resulting new total score of the team that scored.
string
score-team-opposing The current total score of the team was scored upon.
string
comment A textual comment.
string

action-basketball-penalty

Used when a foul is made. | Records who made the foul and who called the foul.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An integer. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
string
period-time-elapsed The time elapsed in the quarter or overtime period.
string
period-time-remaining The time remaining in the quarter or overtime period.
string
recipient-type Whether the receiver of the penalty was the team, the player, a coach, a ref, etc.
recipient-idref A pointer to the receiver of the penalty.
IDREF
caller-idref A pointer to the official who called the penalty.
IDREF
penalty-count How many penalties the recipient has received in this sports-event, including this one.
string
penalty-side Whether it was an offensive or defensive penalty.
penaltySide.Basketball
penalty-level TBD.
penaltyLevel.Basketball
comment A textual comment.
string

action-basketball-timeout

Used to record the calling of a timeout. | Also records who called for the timeout.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An integer. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
string
period-time-elapsed The time elapsed in the quarter or overtime period.
string
period-time-remaining The time remaining in the quarter or overtime period.
string
timeout-duration The duration of the timeout.
string
timeouts-left The number of timeouts remaining once this timeout is finished.
string
caller Who called the timeout.
caller-idref If caller is team, say, a pointer to the team element.
IDREF
comment A textual comment.
string

action-basketball-other

A custom action. | For use when none of the pre-build actions apply.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value An integer. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
string
period-time-elapsed The time elapsed in the quarter or overtime period.
string
period-time-remaining The time remaining in the quarter or overtime period.
string
action-source The name of the controlled-vocabulary for the action-type attribute.
string
action-type A selection from a controlled-vocabulary list maintained by the publisher.
string
comment Textual comment about the action.
string

event-metadata-golf

Holds event metadata specific to golf. | Includes data about the course on which the event is held.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
time-elapsed The amount of time since the start of the golf game.
string
round The round in the tournament.
string
hole Generally an integer, 1 through 18. Could be 19, for a playoff hole.
string
score The total number of shots hit this round.
string
score-under-par The amount of shots under par the player has.
string
course-yardage How long the course is, in yards.
string
course-par What the par value is for the entire 18 holes of the course.
string

team-metadata-golf

Holds metadata about a team (foursome perhaps) playing in the match. | Currently only holds the rank of the team.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
rank How this team ranks among the other competing teams.
string

team-stats-golf

Holds statistics particular to a team of golf players. | Reserved for future use.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string

player-metadata-golf

Holds metadata about a golf player. | Currently only holds the rank of the player.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
rank How this player ranks among the other competing players.
string

player-stats-golf

Holds statistics particular to the player. | Includes performance statistics during the timespan described in date-coverage-scope attributes.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string

stats-golf

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
rounds How many rounds the player has completed in this particular tournament.
string
average Average score of the player.
string
strokes The number of strokes taken by the player.
string
distance The distance the ball travelled on the shot.
string
drives The number of drives made by the player.
string
total-birdies Total number of holes completed at one stroke below par.
string
total-eagles Total number of holes completed at two strokes below par.
string
total-rounds Total number of rounds played during the current tournament.
string
total-strokes Total number of strokes (or swings) made.
string
total-holes Total number of holes played.
string
total-putts Total number of putts attempted.
string
total-points Total score of the player.
string
total-driving Total driving distance.
string
total-par-or-less Total number of holes played by the player at par or less than par.
string
birdies Number of birdies.
string
eagles Number of eagles.
string
saves Number of saves.
string
greens-hit Number of greens ht.
string
bunkers Number of bunkers.
string
eagle-per-holes-frequency Frequency of hitting eagles.
string
percentage Percentage.
string
long-drive Long drive.
string
greens-in-regulation-missed Number of greens missed during regulation play.
string
greens-in-regulation-rank Rank of player in terms of the greens-in-regulation statistic.
string
fairways-hit Number of fairways hit.
string
fairways-possible Maximum number of fairways it was possible to hit.
string
holes-played Number of holes finished.
string
holes-under-par Number of holes finished under par.
string
scoring-adjustment Scoring adjustment.
string
finishes-top-10 Number of finishes the player had in the top ten.
string
finishes-first-place Number of first-place finishes the player had.
string
finishes-second-place Number of second-place finishes the player had.
string
performance-par-3 The performance of the player on par-3 holes.
string
performance-par-4 The performance of the player on par-4 holes.
string
performance-par-5 The performance of the player on par-5 holes.
string
money Amount of money earned by the player.
string
money-value Money value.
string
points Number of points.
string
points-lost Number of points lost.
string
points-gained Number of points gained.
string

stats-golf-round

Statistics pertinent to a round within a tournament. | Allows for hole-by-hole breakdowns.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
round-number The number of the round whose stats are being reported.
string

stats-golf-hole

Statistics pertinent to a particular hole within a golf round. | Includes what score was recorded at that hole, and the par value of the hole.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
hole-type The type of hole played.
holeType.Golf
hole A number, generally from 1 to 18. Alternately, the keyword finished.
string
par The par-value for the hole. Number of strokes needed to reach par.
string
score The number of shots it actually took to sink the ball into the hole.
string
score-under-par The number of shots below par that were scored.
string

tournament-metadata-golf

Holds metadata about a golf tournament. | Currently only holds the rank of the team. ???

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

tournament-division-metadata-golf

Metadata about a particular division within a golf tournament. | Includes information about the course as a whole.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
course-yardage How many yards the course is, measured from tees to holes.
string
course-par The total par value of all holes.
string

event-actions-golf

A holder for actions specific to golf. | Currently holds a golf shot, and a generic golf action element.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

action-golf-shot

A swing of the club at the ball resulting in the ball moving. | A shot moves progressively moves the ball from the tee towards the hole.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
time-elapsed The amount of time since the start of the golf game.
string
round The round in the tournament.
string
hole Generally an integer, 1 through 18. Could be 19, for a playoff hole.
string
score The total number of shots hit this round.
string
score-under-par The amount of shots under par the player has.
string
player-idref
IDREF
club
string
shot-type
string
shot-distance
string
start-distance
string
end-distance
string
landing
string

action-golf-other

A custom action. | For use when none of the pre-build actions apply.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
time-elapsed The amount of time since the start of the golf game.
string
round The round in the tournament.
string
hole Generally an integer, 1 through 18. Could be 19, for a playoff hole.
string
score The total number of shots hit this round.
string
score-under-par The amount of shots under par the player has.
string
action-source The name of the controlled-vocabulary for the action-type attribute.
string
action-type A selection from a controlled-vocabulary list maintained by the publisher.
string
comment Textual comment about the action.
string

event-metadata-ice-hockey

Metadata about the event itself. | Specific to ice-hockey.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
string
period-time-elapsed The time elapsed in the period.
string
period-time-remaining The time remaining in the period.
string

team-metadata-ice-hockey

Metadata about one team. | Specific to ice-hockey.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

team-stats-ice-hockey

Stats about one team. | Specific to ice-hockey.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
plus-minus Number of times players on this team were on ice when own team scored minus the number of times players were on ice when opponent scored.
string
plus-total Number of times players on this team were on ice when own team scored.
string
minus-total Number of times players were on ice when opponent scored.
string
penalty-minutes Total number of penalty minutes accrued by a single team.
string

stats-ice-hockey-offensive

Offensive stats for one team. | Specific to ice-hockey, including stats on shots, goals, and faceoffs.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
goals-game-winning Goals that provided the winning margin in a game.
string
goals-game-tying Goals that caused the game to be tied.
string
goals-power-play Goals scored while the team was having a power-play.
string
goals-short-handed Goals scored while the team was playing short-handed.
string
goals-even-strength Goals scored while the teams were at even strength.
string
goals-empty-net Goals scored on an empty goal, with the opposing goalie pulled from the net.
string
goals-overtime Goals scored during overtime.
string
goals-shootout Goals scored during a shootout.
string
goals-penalty-shot Goals scored as penalty shots.
string
goals-per-game TBD.
string
assists Total number of assists.
string
assists-power-play Total number of assists made during a power play.
string
assists-short-handed Total number of assists made while short-handed.
string
points Total number of points, with a score and an assist generally counted as one point each.
string
points-power-play Total number of points during power plays, with a score and an assist generally counted as one point each.
string
points-short-handed Total number of points while short-handed, with a score and an assist generally counted as one point each.
string
power-play-amount Number of power-play opportunities a team has had.
string
power-play-percentage Measure of success at power plays. Figured by dividing goals-power-play by power-play-amount.
string
shots-penalty-shot-taken Total number of penalty shots taken by a shooting player.
string
shots-penalty-shot-missed Total number of penalty shots missed by a shooting player.
string
shots-penalty-shot-percentage Percentage of penalty shots that resulted in goals.
string
giveaways Number of times that passes were attempted but intercepted. A judgment call whose exact conditions vary.
string
minutes-power-play Total number of minutes played in a power-play.
string
faceoff-wins Total number of won faceoffs.
string
faceoff-losses Total number of lost faceoffs.
string
faceoff-win-percentage Percentage of faceoffs that were won.
string
scoring-chances Total number of qualified chances to score.
string
hat-tricks Total number of hat-trick games.
string

stats-ice-hockey-defensive

Defensive stats for the team. | Specific to ice-hockey, including saves and shots allowed.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
shots-power-play-allowed Total number of shots on goal allowed during power-play.
string
shots-penalty-shot-allowed Total number of shots allowed as penalty-shots.
string
goals-power-play-allowed Total number of goals allowed while the opposing team has a power-play.
string
goals-penalty-shot-allowed Total number of goals allowed as penalty-shots.
string
goals-empty-net-allowed Total number of goals allowed while the net was empty.
string
goals-short-handed-allowed Total number of goals allowed while playing short-handed.
string
goals-against-average Average number of goals per game allowed by the team.
string
saves Total number of saves.
string
save-percentage Percentage of saves compared to total number of shots.
string
penalty-killing-amount Number of penalty-killing sessions, aka number of short-handed sessions.
string
penalty-killing-percentage Equals goals-penalty-allowed divided by penalty-killing-amount.
string
shots-blocked Number of shots that were blocked. This statistic is generally tracked for non-goalies.
string
takeaways Number of intercepted passes. A judgment call whose exact conditions vary.
string
shutouts Total number of games where the opposing team did not score.
string
minutes-penalty-killing Total number of minutes played short-handed, while the other team had a power-play.
string
hits Number of body checks made against an opposing player.
string

player-metadata-ice-hockey

Metadata for a player. | Specific to ice-hockey. Reserved for future use.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

player-stats-ice-hockey

Stats for a player specific to ice-hockey. | Includes the same offensive and defensive stats available for a team.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
plus-minus Number of times player was on ice when own team scored minus the number of times player was on ice when opponent scored.
string
plus-total Number of times player was on ice when own team scored.
string
minus-total Number of times player was on ice when opponent scored.
string
minutes-played Number of minutes player was on ice.
string
penalty-minutes Total number of penalty minutes accrued by a single player.
string

event-actions-ice-hockey

Event actions specific to ice-hockey. | Include scores, penalties, timeouts, etc.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

action-ice-hockey-score-attempt

Used to record shots that are NOT made. | If the shot was made, use the action-ice-hockey-score.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
string
period-time-elapsed The time elapsed in the period.
string
period-time-remaining The time remaining in the period.
string
player-idref A pointer to the player that attempted to score.
IDREF
team-idref A pointer to the team that attempted to score.
IDREF
score-attempt-type The type of shot.
scoreAttemptType.IceHockey
score-attempt-result The result of the shot.
scoreAttemptResult.IceHockey
skaters-on-ice The number of non-goalie skaters on the ice when the team that did the shooting shot the puck.
string
skaters-on-ice-opposing The number of non-goalie skaters on the ice for the team that was shot upon.
string
comment A textual comment.
string

action-ice-hockey-score

Data about a score in ice-hockey. | Includes elements detailing who was on the ice during the score.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
string
period-time-elapsed The time elapsed in the period.
string
period-time-remaining The time remaining in the period.
string
score-attempt-type The type of shot. Called attempt because it shares the same values as score-attempt element.
scoreAttemptType.IceHockey
player-idref A pointer to the player that scored the goal.
IDREF
team-idref A pointer to the team that scored the goal.
IDREF
comment A textual comment.
string
score-team After this action took place, the score of the team that team-idref points to.
string
score-team-opposing After this action took place, the score of the team opposing that listed in team-idref.
string
skaters-on-ice The number of non-goalie skaters on the ice when the team that did the shooting shot the puck.
string
skaters-on-ice-opposing The number of non-goalie skaters on the ice for the team that was shot upon.
string

action-ice-hockey-assisting-player

Player who assisted with a score. | Generally, a player who passed the puck to the player who scored.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
player-idref A pointer to a player who assisted in the score.
IDREF

action-ice-hockey-scoring-players

Player who was on the ice playing for the side that scored a goal. | One element is used for each player who was on the ice when a score was made.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
player-idref A pointer to a player on ice during a score.
IDREF

action-ice-hockey-scored-on-players

Player who was on the ice playing for the side that was scored upon. | One element is used for each player who was on the ice when the score was made.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
player-idref A pointer to a player who was on ice when a score was made.
IDREF

action-ice-hockey-penalty

Action describing a penalty. | Includes who caused and who called the penalty. One element is used per penalized player.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
string
period-time-elapsed The time elapsed in the period.
string
period-time-remaining The time remaining in the period.
string
recipient-type Whether the receiver of the penalty was the team, the player, a coach, a ref, etc.
recipient-idref A pointer to the receiver of the penalty.
IDREF
served-by-idref A pointer to the player that served the penalty.
IDREF
caller-idref A pointer to the official who called the penalty.
IDREF
penalty-status Whether this action indicates the start of a penalty, or the end of a penalty.
penalty-level TBD.
penaltyLevel.IceHockey
penalty-name TBD.
penaltyName.IceHockey
penalty-length In minutes:seconds. Not necessarily the time actually served.
string
comment A textual comment.
string

action-ice-hockey-substitution

Description of a substitution. | Describes who substituted for whom, and why.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
string
period-time-elapsed The time elapsed in the period.
string
period-time-remaining The time remaining in the period.
string
person-type The type of person who is substituting, for example: a player, a coach, a referree.
person-original-idref A pointer to the player who left the ice.
IDREF
person-original-position The position of the player who left the ice. Could be a goalie.
position.IceHockey
person-replacing-idref A pointer to the player who now went on the ice.
IDREF
person-replacing-position The position of the player who went on the ice. If original player was a goalie, and this value is a forward, than the goalie has been pulled.
position.IceHockey
substitution-reason The reason why a substitution was made.
string
comment A textual comment.
string

action-ice-hockey-timeout

Description of a timeout. | Includes the duration of the timeout, and who called for the timeout.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
string
period-time-elapsed The time elapsed in the period.
string
period-time-remaining The time remaining in the period.
string
timeout-duration How long a timeout was called for.
string
caller Who called the timeout, either team or official.
caller-idref If caller is team, say, a pointer to the team element.
IDREF
comment A textual comment.
string

action-ice-hockey-other

A custom action. | For use when none of the pre-build actions apply.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1,2,3 for main periods, 4 for first overtime, etc. shootout also allowed value.)
string
period-time-elapsed The time elapsed in the period.
string
period-time-remaining The time remaining in the period.
string
action-source The name of the controlled-vocabulary for the action-type attribute.
string
action-type A selection from a controlled-vocabulary list maintained by the publisher.
string
comment Textual comment about the action.
string

event-metadata-soccer

Soccer-specific metadata for events. | Metadata that is specific to soccer for events.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
string
period-time-elapsed Detailed time MMSS that has elapsed.
string
period-minute-elapsed The time elapsed, but only given as whole minutes.
string
period-time-remaining Detailed time in MMSS format showing remaining time of period.
string
kick-off-team-idref Pointer to the team doing the kick-off for the period covered.
IDREF

time-adjustment

Record time added by referee. | Holds values for the time added by the referee and how much extra time was actually played.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
string
period-time-elapsed Detailed time MMSS that has elapsed.
string
period-minute-elapsed The time elapsed, but only given as whole minutes.
string
period-time-remaining Detailed time in MMSS format showing remaining time of period.
string
period-extra-time-added How many minutes the referee has decided to add to the period.
string
period-extra-time-elapsed How much time exactly MMSS that was actually elapsed in the period.
string

team-metadata-soccer

Soccer specific metadata for one team. | The team-metadata that is specific for soccer and does not apply in all sports.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

team-stats-soccer

Soccer specific stats for one team. | Team-stats that is specific to soccer and does not apply to all sports.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string

stats-soccer-offensive

Offensive stats specific to soccer. | Offensive stats for one team, specific to soccer.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
goals-game-winning Goals that meant winning a game.
string
goals-game-tying Goals that meant tying a game.
string
goals-overtime Goals scored during overtime.
string
goals-shootout Goals scored during shootout.
string
goals-total TBD.
string
assists-game-winning Assists to goals that meant winning a game.
string
assists-game-tying Assists to goals that meant tying a game.
string
assists-overtime Assists made on goals scored during overtime.
string
assists-total Number of assists.
string
points Sum of goals and assists.
string
shots-total TBD.
string
shots-on-goal-total TBD.
string
shots-penalty-shot-taken Total number of attempts to score as penalty-shot.
string
shots-penalty-shot-scored Goals scored as penalty-shots.
string
shots-penalty-shot-missed Total number of attempts to score as penalty-shot that did not result in a goal.
string
shots-penalty-shot-percentage Percentage of penalty shots scored. Could be calculated from above values.
string
shots-shootout-taken Total number of attempts to score during shootout.
string
shots-shootout-scored Goals scored during shootout.
string
shots-shootout-missed Goals missed during shootout.
string
shots-shootout-percentage Percentage of shootout goals scored.
string
giveaways When you play bad so the other team gets hold of the ball/puck.
string
offsides Total number of offsides.
string
corner-kicks Total number of corner kicks performed.
string
hat-tricks A record of the number of times a player scored three or more goals in a game. Sometimes, the rules that govern the assignment of a hat-trick varies.
string

stats-soccer-defensive

Defensive stats specific to soccer. | Defensive stats for one team, specific to soccer.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
shots-penalty-shot-allowed Total number of penalty-shots allowed from other teams.
string
goals-penalty-shot-allowed Total number of goals allowed as penalty shots.
string
goals-against-average Average goals against per game for the given period.
string
goals-against-total TBD.
string
saves Score attempts that were saved by the goal-keeper.
string
save-percentage Percentage of saves compared to score-attempts on goal.
string
catches-punches Situations when the goalie catches or punches the ball. Not a save attempt.
string
shots-on-goal-total TBD.
string
shots-shootout-total Total number of attempts to score during shootout.
string
shots-shootout-allowed Goals allowed during shootout.
string
shots-blocked Score attempts that was blocked by someone else than the goal-keeper.
string
shutouts Number of games when you did not allow the other team to score.
string

stats-soccer-foul

Stats specific to fauls, cautions, and ejections. | Could occur while players are on the offense, the defense, or even the bench.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
fouls-commited Total number of fouls commited. Generally a defensive foul.
string
fouls-suffered Total number of fouls the player has suffered. Generally an offensive foul.
string
cautions-total Total number of cautions recieved.
string
cautions-pending Number of cautions that could result in a game suspension.
string
caution-points-total Total amount of caution points. Can occur over various games in a season.
string
caution-points-pending Number of caution points that could result in a game suspension.
string
ejections-total Total number of ejections.
string

player-metadata-soccer

Player metadata specific to soccer. | Metadata for one player, specific to soccer.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

player-stats-soccer

Player statistics that are specific to soccer. | Soccer specific statistic information about a player.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string

event-actions-soccer

Action specific to soccer. | Actions that are specific to soccer.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

action-soccer-substitution

Substition of a person involved in a game. | Substitution of one person for another in a given position in a game. Not limited to players.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
string
period-time-elapsed Detailed time MMSS that has elapsed.
string
period-minute-elapsed The time elapsed, but only given as whole minutes.
string
period-time-remaining Detailed time in MMSS format showing remaining time of period.
string
person-type What position the person beeing replaced held.
person-original-idref A pointer to the person beeing replaced.
IDREF
person-original-position Position the replaced person held.
position.Soccer
person-replacing-idref A pointer to the person replacing.
IDREF
person-replacing-position Position the substitute will take up. External controlled vocabulary: sportsml-vocabulary-specific-soccer.position
string
substitution-reason Text explaining the reason for the substitute.
string
team-idref A pointer to the team doing the substitution.
IDREF
comment Textual comment regarding this substitution.
string

action-soccer-score-attempt

Only used if the attempt is not also a goal. | When a player attempts to score a goal but it does not result in a goal.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
string
period-time-elapsed Detailed time MMSS that has elapsed.
string
period-minute-elapsed The time elapsed, but only given as whole minutes.
string
period-time-remaining Detailed time in MMSS format showing remaining time of period.
string
player-idref idref pointing to the player attempting to score.
IDREF
team-idref idref pointing to the team for which the player attempting to score.
IDREF
score-attempt-method How the player attempted to score. Using head, left leg, right leg etc. External controlled vocabulary: sportsml-vocabulary-specific-soccer.score-attempt-method
string
score-attempt-type What type of attempt. External controlled vocabulary: sportsml-vocabulary-specific-soccer.score-attempt-type
string
score-attempt-result What the attempt resulted in Values in external controlled vocabulary: sportsml-vocabulary-specific-soccer.score-attempt-result
string
comment Textual comment regarding this score-attempt.
string

action-soccer-score

When a team scores a goal. | Records by whom, how and when a goal was scored and the standing after the goal.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
string
period-time-elapsed Detailed time MMSS that has elapsed.
string
period-minute-elapsed The time elapsed, but only given as whole minutes.
string
period-time-remaining Detailed time in MMSS format showing remaining time of period.
string
score-attempt-method How the player attempted to score. Using head, left leg, right leg etc.
string
score-attempt-type What type of attempt. Values in external controlled vocabulary: sportsml-vocabulary-specific-soccer.score-attempt-type (Note that the same attribute names are used as in score-attempt to avoid the need for duplicated vocabularies.)
string
player-idref idref pointing to the player attempting to score.
IDREF
team-idref idref pointing to the team for which the player attempting to score.
IDREF
score-team The current score for the scoring team after the score is counted.
string
score-team-opposing The current score for the opposing team after the score is counted.
string
comment Textual comment about the score.
string

action-soccer-assisting-player

Player assisting to score a goal. | Pointer or identification of player assisting in scoring a goal.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
player-idref idref pointing to the player attempting to score.
IDREF

action-soccer-offside

When an offside occurs. | Records the event of an offside in a game.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
string
period-time-elapsed Detailed time MMSS that has elapsed.
string
period-minute-elapsed The time elapsed, but only given as whole minutes.
string
period-time-remaining Detailed time in MMSS format showing remaining time of period.
string
team-idref idref pointing to the team causing the offside.
IDREF
player-offside-idref idref pointing to the player the lineman indicated was offisde.
IDREF
player-passing-idref idref pointing to the player passing the ball when offside was called.
IDREF
comment Textual comment regarding the offside.
string

action-soccer-foul

When a player commits an infraction against the rules, which may or may not result in a penalty. | Records what happens (or not happens) when a player commits a foul. Cautions and ejections are recorded under penalty.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
string
period-time-elapsed Detailed time MMSS that has elapsed.
string
period-minute-elapsed The time elapsed, but only given as whole minutes.
string
period-time-remaining Detailed time in MMSS format showing remaining time of period.
string
fouling-team-idref idref pointing to the team causing the foul.
IDREF
fouling-player-idref idref pointing to the player causing the foul.
IDREF
fouled-team-idref idref pointing to the team beeing fouled.
IDREF
fouled-player-idref idref pointing to the player beeing fouled.
IDREF
foul-name The name of the foul was committed. External controlled vocabulary: sportsml-vocabulary-specific-soccer.foul-name
string
foul-result External controlled vocabulary: sportsml-vocabulary-specific-soccer.foul-result
string
comment Textual comment regarding the penalty.
string

action-soccer-penalty

Results from a foul. | Details of a penalty that a foul resulted in.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
string
period-time-elapsed Detailed time MMSS that has elapsed.
string
period-minute-elapsed The time elapsed, but only given as whole minutes.
string
period-time-remaining Detailed time in MMSS format showing remaining time of period.
string
recipient-type What type of person or team that got the penalty.
recipient-idref idref pointer to the person suffering the penalty.
IDREF
caller-idref idref pointing to who called the penalty.
string
penalty-type External controlled vocabulary: sportsml-vocabulary-specific-soccer.penalty-type
string
penalty-level External controlled vocabulary: sportsml-vocabulary-specific-soccer.penalty-level
string
caution-value Used to indicate what value, if any, the penalty adds to the caution-total of the player.
string
comment Textual comment regarding the penalty.
string

action-soccer-timeout

A timeout is called. | How, when and what type of timeout was called.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
string
period-time-elapsed Detailed time MMSS that has elapsed.
string
period-minute-elapsed The time elapsed, but only given as whole minutes.
string
period-time-remaining Detailed time in MMSS format showing remaining time of period.
string
timeout-duration The duration of the timeout.
string
caller Who called the timeout, either team or official.
caller-idref If caller is team, say, an idref pointer to the team element.
IDREF
comment Textual comment about the timeout.
string

action-soccer-other

A custom action. | For use when none of the pre-build actions apply.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
period-value Identifier for which period of a game. (1, 2 for first and second halfs, 3 for first overtime, etc. shootout also allowed value.).
string
period-time-elapsed Detailed time MMSS that has elapsed.
string
period-minute-elapsed The time elapsed, but only given as whole minutes.
string
period-time-remaining Detailed time in MMSS format showing remaining time of period.
string
action-source The name of the controlled-vocabulary for the action-type attribute.
string
action-type A selection from a controlled-vocabulary list maintained by the publisher.
string
comment Textual comment about the action.
string

event-metadata-tennis

Metadata about the specific tennis match. | When in the match this document was issued.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
set An integer, 1,2,3,4,5.
string
game An integer, generally 1 through 7.
string
server-idref A pointer to the player who served the ball on this point.
IDREF
server-score Either love, 15, 30, 40, game.
receiver-idref A pointer to the player who received the served ball on this point.
IDREF
receiver-score Either love, 15, 30, 40, game.
serve-number Identifying either the first or second serve.

team-metadata-tennis

A placeholder for event metadata specific for tennis. | Reserved for future use.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

team-stats-tennis

Holds tennis-specific stats. Used for doubles matches. | Generally having to do with the score of the match.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string

stats-tennis-set

Holds the score of a set. | Includes an attribute for a set's tiebreaker score.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
set-number An integer, generally 1 through 7.
string
score Either love, 15, 30, 40, game.
string
score-tiebreaker An integer. Generally 0 through 7.
string

stats-tennis-game

Holds the score of a game. | Also holds details of each point.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string
score Either love, 15, 30, 40, or game.

player-metadata-tennis

Holds metadata specific to a tennis player. | Reserved for future use.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

player-stats-tennis

Holds tennis-specific stats. Used for singles matches. | Generally having to do with the score of the match.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
stats-coverage A relative indication of how many statistics are included in the item.
statsCoverage.Core
team-coverage Indicates whether the item contains information about one team, or many teams.
teamCoverage.Core
date-coverage-type Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season.
dateCoverageType.Core
date-coverage-value Value that further describes the dates covered. Example: if type is season, value can be 2001-2002.
string
duration-scope Indicates what class of events the included statistics apply. Example: those events that went into overtime.
durationScope.Core
competition-scope Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division.
competitionScope.Core
alignment-scope Indicates that the included statistics apply only to events played either at home or away.
alignmentScope.Core
position-scope Indicates that the included statistics apply only to while played at a particular position.
string
record-making-scope Indicates that the included statistics apply only to values that set a record, such as a team-high, or an individual-low.
recordMakingScope.Core
scoping-label A textual description for the scope.
string

event-actions-tennis

A holder for actions taking place in a tennis match. | Either a tennis point, or a custom action.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID

action-tennis-point

Can be recorded whenever a point is won. | Includes an identifier for how that point was one.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
set An integer, 1,2,3,4,5.
string
game An integer, generally 1 through 7.
string
server-idref A pointer to the player who served the ball on this point.
IDREF
server-score Either love, 15, 30, 40, game.
receiver-idref A pointer to the player who received the served ball on this point.
IDREF
receiver-score Either love, 15, 30, 40, game.
serve-number Identifying either the first or second serve.
winner-idref A pointer to the player or team (for doubles) who won the point.
IDREF
win-type TBD.
winType.Tennis

tournament-metadata-tennis

For holding metadata having to do with a tennis tournament. | Includes an attribute for the name of the tennis tour.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
tour-name The name of the tour.
string

action-tennis-other

A custom action. | For use when none of the pre-build actions apply.

Attributes

NameDescription
Type (Declaration)
id An XML-specific identifier for the element.
ID
set An integer, 1,2,3,4,5.
string
game An integer, generally 1 through 7.
string
server-idref A pointer to the player who served the ball on this point.
IDREF
server-score Either love, 15, 30, 40, game.
receiver-idref A pointer to the player who received the served ball on this point.
IDREF
receiver-score Either love, 15, 30, 40, game.
serve-number Identifying either the first or second serve.
action-source The name of the controlled-vocabulary for the action-type attribute.
string
action-type A selection from a controlled-vocabulary list maintained by the publisher.
string
comment Textual comment about the action.
string

placeholder-element

Not a true SportsML element | Just an empty placeholder to be used if Specific extension has no children.