Match
A 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 Tournament
.
If a Match
includes Lineup
objects on its MatchTeam
objects and includes MatchQuestion
objects, a complete scoresheet can be reconstructed.
tossups_read | Number | The number of tossups read, including any tossups read in overtime. This should be absent or null (not |
---|---|---|
overtime_tossups_read | Number | The number of tossups read in overtime. This should be absent or null (not |
location | String | The location of the match. Probably a room name. |
packets | String | The packet(s) used for the match if different from that implied by the |
tiebreaker | Boolean | Was the match a tiebreaker match? |
moderator | String | Moderator's name. |
scorekeeper | String | Scorekeeper's name. |
serial | String | "For control room use only"-type serial number. |
match_teams | Array of MatchTeam | The performances of the teams in this match; see below. |
carryover_phases | Array of Phase | 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 MatchQuestion | The question-by-question account of what happened. |
notes | String | Freeform text field to record any notes about the match, such as protests or questions read out of order. |
MatchTeam
team | Team | The team playing this side of the match. At least one of |
---|---|---|
card | String | The card this team was holding at the beginning of this match. At least one of |
forfeit_loss | Boolean | Did this team forfeit this match? If absent, assumed to be |
points | Number | The total score for this team in this match. It is invalid to provide both |
bonus_points | Number | The number of points this team earned on bonuses. It is invalid to provide both |
correct_tossups_without_bonuses | Number | The number of tossups this team answered correctly (in any form) without earning a bonus. If absent, assumed to be |
bonus_bounceback_points | Number | The number of points this team earned on bonuses bounced back from the opponent. |
lightning_points | Number | The number of points this team earned on lightning questions. |
lightning_bounceback_points | Number | The number of points this team earned on lightning questions bounced back from the opponent. |
match_players | Array of MatchPlayer | The performances of the players on this team; see below. |
lineups | Array of Lineup | Which players were playing when; see below. |
signature | Signature | 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. |
suppress_from_statistics | Boolean | Indicates that the match should be excluded from calculations of standings, statistics, etc. If absent, this will be assumed to be |
MatchPlayer
player | Player | The player whose performance in this match is being stored. |
---|---|---|
tossups_heard | Number | The number of tossups this player heard. |
answer_counts | Array of PlayerAnswerCount | The number of this player's answers for each answer value. |
PlayerAnswerCount
number | Number | Number of questions answered for this many points. |
---|---|---|
answer_type | AnswerType | For nonstandard question types, the particular details about this answer type. |
Lineup
first_question | Number | 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 Player | 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 |
captain | Player | 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. If 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". |
Signature
image_url | String | 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. |
---|---|---|
notes | String | Any comments the signer made related to acceptance of the result. |
MatchQuestion
question_number | Number | Which tossup-bonus cycle number this was. Starts at 1. |
---|---|---|
tossup_question | Question | Information about the tossup question in this cycle. |
tossup_start_time | Date | 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. |
replacement_tossup_question | Question | 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. |
replacement_tossup_start_time | Date | 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 MatchTeam | The |
buzzes | Array of MatchQuestionBuzz | 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. |
bonus_points | Number | 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 |
bonus_bounceback_points | Number | How many bonus points were awarded when this question's bonus bounced back. May be omitted if |
bonus | MatchQuestionBonus | Information about the bonus that was read for this question. Must be omitted if |
bonus_start_time | Date | 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. |
replacement_bonus | MatchQuestionBonus | 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. |
MatchQuestionBuzz
team | Team | Which team's player buzzed in. |
---|---|---|
player | Player | Which player buzzed in. |
buzz_position | BuzzPosition | Details on the timing of the buzz. |
result | AnswerType | The result of the player's buzz, representing how many points the player's team received. |
BuzzPosition
time | Date | 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. |
---|---|---|
word_index | Number | The ( |
clue_index | Number | The ( |
MatchQuestionBonus
question | Question | Information about the question used as a bonus. |
---|---|---|
parts | Array of MatchQuestionBonusPart | Information about each part of the bonus. |
eligible_match_teams | Array of MatchTeam | The |
MatchQuestionBonusPart
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 MatchQuestionBonusPart
.
controlled_points | Number | Number of points earned by the controlling team. In all formats with which we are familiar, this must be a nonnegative integer. |
---|---|---|
bounceback_points | Number | 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 |