Packet

nameString

A human-readable identifier. Often primarily numeric (e.g., Packet 1), but could also be identified by authors (Chicago or Yale + Maryland), as for packet-submission tournaments.

numberNumber

The packet number, if that notion is meaningful. May also be contained in the name, but need not be, e.g. if both number and authors are specified, the name will typically only contain one of them (whichever is more important).

authorsArray of String

The authors of the packet. May also be contained in the name, but need not be, e.g. if both number and authors are specified, the name will typically only contain one of them (whichever is more important).

roleOne of the following:
  • regular
  • finals
  • extra
  • overtime
  • replacement
  • backup
  • tiebreaker
  • scrimmage

How the packet is expected to be used. An extra packet typically consists only of tossups, and is for use in overtime and/or as replacements, as necessary. Note that a packet might be used differently in case of unusual situations.

notesString

Any further details on the packet.

questionsArray of Question

The contents of the packet, in order.

Question

This object can be reused for every time the same question is read, i.e., it represents a question in general rather than a question being read in a specific match.

question_numberNumber

The number of the question in the packet.

typeOne of the following:
  • tossup
  • bonus
  • lightning

The type of the question.

partsNumber

The number of parts the question has (typically 1 if type is tossup and 3 if type is bonus, but some formats may vary).

external_idString

The identifier for the question in some external system, if any (e.g., the question IDs that NAQT prints below each question in its packet).

categoryString

Freeform information about the question's category, e.g. British History.

category_groupString

Freeform information about the question's category at a higher level of aggregation, e.g. History.

textString

The text of the question (as a single field).

cluesArray of String

The text of the question, broken up into clues so that BuzzPositions can reference which clue was being buzzed on. Defining "clue" is outside the scope of this schema.