# com.nerdballot.filmBallot

> One record per track. The record key is {award}-{eligibilityYear}-{category}, for example oscar-2026-picture or golden-globe-2026-musical-comedy. Array order is rank order: first earns 5 points, fifth earns 1.

- Kind: record
- Record key: any
- Authority: nerdballot.com
- Lexicon: 1
- Published by [nerdballot.com](https://lexicon.garden/identity/did:plc:h4wwy6staenmbvom5rnwz3no), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:h4wwy6staenmbvom5rnwz3no/com.nerdballot.filmBallot)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:h4wwy6staenmbvom5rnwz3no/com.nerdballot.filmBallot/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:h4wwy6staenmbvom5rnwz3no/com.nerdballot.filmBallot/analytics)

## Record (`com.nerdballot.filmBallot`)

Type: record · key any

### Properties

- `award` (string, required)
  - Constraints: maxLength: 32, knownValues: oscar | golden-globe
- `category` (string, required)
  - Constraints: maxLength: 32, knownValues: picture | drama | musical-comedy
- `eligibilityYear` (integer, required): Release year of the films on the ballot.
  - Constraints: minimum: 1900, maximum: 2100
- `rankedFilms` (array, required): AT-URIs of com.nerdballot.film records, best first. No duplicates.
  - Constraints: maxLength: 5
  - `items` (string · at-uri)
- `updatedAt` (string · datetime, required): Client time of the edit. Informational only; Nerd Ballot uses its own receipt time for deadlines.
- `version` (integer, required): Schema version of this record. Currently 1.
  - Constraints: minimum: 1

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "One record per track. The record key is {award}-{eligibilityYear}-{category}, for example oscar-2026-picture or golden-globe-2026-musical-comedy. Array order is rank order: first earns 5 points, fifth earns 1.",
      "key": "any",
      "record": {
        "properties": {
          "award": {
            "knownValues": [
              "oscar",
              "golden-globe"
            ],
            "maxLength": 32,
            "type": "string"
          },
          "category": {
            "knownValues": [
              "picture",
              "drama",
              "musical-comedy"
            ],
            "maxLength": 32,
            "type": "string"
          },
          "eligibilityYear": {
            "description": "Release year of the films on the ballot.",
            "maximum": 2100,
            "minimum": 1900,
            "type": "integer"
          },
          "rankedFilms": {
            "description": "AT-URIs of com.nerdballot.film records, best first. No duplicates.",
            "items": {
              "format": "at-uri",
              "type": "string"
            },
            "maxLength": 5,
            "type": "array"
          },
          "updatedAt": {
            "description": "Client time of the edit. Informational only; Nerd Ballot uses its own receipt time for deadlines.",
            "format": "datetime",
            "type": "string"
          },
          "version": {
            "description": "Schema version of this record. Currently 1.",
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "version",
          "award",
          "eligibilityYear",
          "category",
          "rankedFilms",
          "updatedAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A voter's ranked ballot for one Nerd Ballot film track. Nerd Ballot is an unofficial community poll, not affiliated with the Academy of Motion Picture Arts and Sciences or the Golden Globes.",
  "id": "com.nerdballot.filmBallot",
  "lexicon": 1
}
```