Hugo nomination statistics schema 2025-10 [DRAFT]

View schema

Type: object

Statistics for the nomination stage of the Hugo Awards for a given year.

root version
Type: string

Version of the format this document follows.
Example:

"2025-10"

root year
Type: integer

Year of the award these statistics are for.
Example:

2025

root numBallots
Type: integer

Number of valid nomination ballots received.

root categories
Type: array

The categories in the award, in the order they appeared on the nomination ballot.

 No Additional Items

Each item of this array must be:

root categories category
Type: object

A category in the award.

root categories categories items name
Type: string

Name of the category, as it appeared on the nomination ballot.
Examples:

"Best Novel"

"Best Dramatic Presentation, Long Form"

root categories categories items numBallots
Type: integer

Number of valid nomination ballots received for this category. May be less than the total number of valid nomination ballots if some ballots did not nominate in this category.

root categories categories items numNominees
Type: integer

Number of unique candidates nominated in this category. Note, this may include ineligible nominees.

root categories categories items nominees
Type: array

Highest ranked nominees for the category. Contains at least the finalists, but typically 10 more.

 No Additional Items

Each item of this array must be:

root categories categories items nominees nominee
Type: object

Candidate nominated for a category.

If the conditions in the "If" tab are respected, then the conditions in the "Then" tab should be respected. Otherwise, the conditions in the "Else" tab should be respected.

root categories categories items nominees nominees items if
Type: object

root categories categories items nominees nominees items if removed
Type: const
Specific value: true
root categories categories items nominees nominees items then
Type: object

root categories categories items nominees nominees items then removedReason
Type: string

Reason for removal, if the nominee was removed.
Examples:

"Deemed ineligible because it was first published in 2024."

"Declined nomination in this category."

root categories categories items nominees nominees items name
Type: string

Name of the nominee. For example, the name of a book, or a person.
Examples:

"Vacuum Protocols"

"Starlight Quarterly"

"Jane Doe"

root categories categories items nominees nominees items nominations
Type: integer

Number of nomination ballots that nominated this nominee.

root categories categories items nominees nominees items rank
Type: integer

Rank of the nominee, indicating their elimination order in the EPH process. Nominees who are not eliminated have rank 0. Nominees eliminated in the last round have rank 1, those eliminated in the previous round have rank 2, and so on. Higher rank values mean the nominee was eliminated earlier in the process.

Value must be greater or equal to 0

root categories categories items nominees nominees items finalist
Type: boolean

Indicates if the nominee appeared as a finalist on the ballot for this category. If absent, the finalist status is unknown.

root categories categories items nominees nominees items removed
Type: boolean

Indicates if the nominee was removed from consideration (e.g. due to ineligibility or declining nomination). If absent, it is unknown if they are a removed.

root categories categories items rounds
Type: array

Rounds in which nominees are eliminated. Only enough rounds needed to describe how the non-finalist nominees listed are eliminated are provided.

 No Additional Items

Each item of this array must be:

root categories categories items rounds round
Type: object

Round in which one or more nominees are eliminated.

root categories categories items rounds rounds items number
Type: integer

Which 1-indexed round number this is.

root categories categories items rounds rounds items scaledPoints
Type: array of integer

Points assigned to each non-eliminated nominee at the start of this round, listed in the same order as the nominees array. Values are multiplied by 60 to avoid rounding errors; divide by 60 to obtain the actual points.

Must contain a minimum of 1 items

No Additional Items

Each item of this array must be:

root categories categories items rounds rounds items scaledPoints scaledPoints items
Type: integer

Points assigned to the nominee, multiplied by 60.

root categories categories items rounds rounds items survivors
Type: array of integer

Indices of nominees (from the nominees array) that were eligible for elimination this round due to low ranking, but survived. May be empty if no nominees survived.

Must contain a minimum of 0 items

No Additional Items

Each item of this array must be:

root categories categories items rounds rounds items survivors survivors items
Type: integer

0-based index into the nominees array.

Value must be greater or equal to 0

root categories categories items rounds rounds items eliminated
Type: array of integer

Indices of nominees (from the nominees array) that were eliminated in this round.

Must contain a minimum of 1 items

No Additional Items

Each item of this array must be:

root categories categories items rounds rounds items eliminated eliminated items
Type: integer

0-based index into the nominees array.

Value must be greater or equal to 0