Match object describes a single match scheduled between two teams. A
Match object with
MatchTeam objects but without
MatchPlayer objects can be used to describe a match that has been scheduled but not played. Matches are contained in
Round objects, which are contained in
Phase objects of the
Lineup objects on its
MatchTeam objects and includes
MatchQuestion objects, a complete scoresheet can be reconstructed.
The number of tossups read, including any tossups read in overtime. This should be absent or null (not
The number of tossups read in overtime. This should be absent or null (not
The location of the match. Probably a room name.
The packet(s) used for the match if different from that implied by the
Was the match a tiebreaker match?
"For control room use only"-type serial number.
|match_teams||Array of |
The performances of the teams in this match; see below.
|carryover_phases||Array of |
Additional phases in which this match should count, besides the one that actually contains it. This is used for "carrying over" games.
|match_questions||Array of |
The question-by-question account of what happened.
Freeform text field to record any notes about the match, such as protests or questions read out of order.
The team playing this side of the match.
At least one of
The card this team was holding at the beginning of this match.
At least one of
Did this team forfeit this match? If absent, assumed to be
The total score for this team in this match.
It is invalid to provide both
The number of points this team earned on bonuses.
It is invalid to provide both
The number of tossups this team answered correctly (in any form) without earning a bonus. If absent, assumed to be
The number of points this team earned on bonuses bounced back from the opponent.
The number of points this team earned on lightning questions.
The number of points this team earned on lightning questions bounced back from the opponent.
|match_players||Array of |
The performances of the players on this team; see below.
|lineups||Array of |
Which players were playing when; see below.
An object containing information that documents a team's acceptance of the result of the match. The absence of this object could mean the team has not yet accepted the result, the team has refused to accept the result, or simply that the tournament does not care to track acceptance of results. The exact meaning of "acceptance" is up to the tournament—it could mean acceptance of the overall outcome, acceptance of the final score, acceptance of every detail, or something else.
Indicates that the match should be excluded from calculations of standings, statistics, etc. If absent, this will be assumed to be
The player whose performance in this match is being stored.
The number of tossups this player heard.
|answer_counts||Array of |
The number of this player's answers for each answer value.
Number of questions answered for this many points.
For nonstandard question types, the particular details about this answer type.
Which question number this lineup heard first. The players in this lineup will be credited with hearing all tossups until another lineup takes precendence or until the end of the game, whichever comes first.
|players||Array of |
Which players were in this lineup, in the same order that they would appear on the scoresheet. This array's length is less than or equal to the
Which player serves as the captain during the time this
|reason||One of the following:|
What opportunity the team had to set or change its lineup.
The "segment_break" option represents a moment between portions of a match such as the end of the first quarter in a four-quarter format. "halftime" can be thought of as equivalent to "segment_break" for the common case of match formats whose regulation segments are simply two halves. "before_overtime" can be thought of as a special case of "segment_break".
The URL of an image of the signature of a member of the team (typically a coach or captain), indicating their acceptance of the result.
Any comments the signer made related to acceptance of the result.
Which tossup-bonus cycle number this was. Starts at 1.
Information about the tossup question in this cycle.
The time at which the moderator began reading the tossup. An ISO 8601-formatted string, with time zone, in the tournament's local time zone.
Information about the tossup question used as a replacement in this cycle, if any. Omit if the tossup was not replaced. Multiple replacement tossups are not currently supported.
The time at which the moderator began reading the replacement tossup. An ISO 8601-formatted string, with time zone, in the tournament's local time zone.
|replacement_tossup_question_match_teams||Array of |
|buzzes||Array of |
The number of points scored and by whom on each buzz. The length of this array will be equal to or less than the number of teams playing the match.
How many bonus points were awarded on this question. May be omitted if the question type doesn't award a bonus; must be omitted if
How many bonus points were awarded when this question's bonus bounced back. May be omitted if
Information about the bonus that was read for this question. Must be omitted if
The time at which the moderator began reading the bonus. An ISO 8601-formatted string, with time zone, in the tournament's local time zone.
Information about the bonus question used as a replacement in this cycle, if any. Omit if the bonus was not replaced. Multiple replacement bonuses are not currently supported.
Which team's player buzzed in.
Which player buzzed in.
Details on the timing of the buzz.
The result of the player's buzz, representing how many points the player's team received.
The time of the buzz. An ISO 8601-formatted string, with time zone, in the tournament's local time zone. May not be before the start time of reading the relevant question.
Information about the question used as a bonus.
|parts||Array of |
Information about each part of the bonus.
|eligible_match_teams||Array of |
For bonuses that do not have distinguishable parts — e.g. “Name any m of the n things that…” or 30–20–10-style bonuses, treat the entire bonus as a single
Number of points earned by the controlling team. In all formats with which we are familiar, this must be a nonnegative integer.
Number of points earned by the non-controlling team. May be omitted if bonuses do not bounce back, but should not be omitted merely because the non-controlling team earned no points.
In all formats with which we are familiar, this must be a nonnegative integer. Usually it can only be positive if