# com.nerdballot.film

> One record per film. The record key is the film's Nerd Ballot catalog id.

- Kind: record
- Record key: tid
- 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.film)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:h4wwy6staenmbvom5rnwz3no/com.nerdballot.film/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:h4wwy6staenmbvom5rnwz3no/com.nerdballot.film/analytics)

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

Type: record · key tid

### Properties

- `createdAt` (string · datetime, required)
- `directors` (array, required)
  - Constraints: maxLength: 20
  - `items` (string)
    - Constraints: maxLength: 1000, maxGraphemes: 100
- `isSample` (boolean): True for fake films used to test the site.
- `releaseDate` (string): US theatrical release date, YYYY-MM-DD.
  - Constraints: maxLength: 10
- `runtimeMinutes` (integer)
  - Constraints: minimum: 1, maximum: 1000
- `title` (string, required)
  - Constraints: maxLength: 3000, maxGraphemes: 300
- `tmdbId` (integer): The Movie Database (TMDB) film id.
  - Constraints: minimum: 1
- `version` (integer, required)
  - Constraints: minimum: 1

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "One record per film. The record key is the film's Nerd Ballot catalog id.",
      "key": "tid",
      "record": {
        "properties": {
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "directors": {
            "items": {
              "maxGraphemes": 100,
              "maxLength": 1000,
              "type": "string"
            },
            "maxLength": 20,
            "type": "array"
          },
          "isSample": {
            "description": "True for fake films used to test the site.",
            "type": "boolean"
          },
          "releaseDate": {
            "description": "US theatrical release date, YYYY-MM-DD.",
            "maxLength": 10,
            "type": "string"
          },
          "runtimeMinutes": {
            "maximum": 1000,
            "minimum": 1,
            "type": "integer"
          },
          "title": {
            "maxGraphemes": 300,
            "maxLength": 3000,
            "type": "string"
          },
          "tmdbId": {
            "description": "The Movie Database (TMDB) film id.",
            "minimum": 1,
            "type": "integer"
          },
          "version": {
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "version",
          "title",
          "directors",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A film in the Nerd Ballot catalog, published by the Nerd Ballot account. Film ballots reference these records by AT-URI.",
  "id": "com.nerdballot.film",
  "lexicon": 1
}
```