# xyz.opnshelf.episode

> Published by [opnshelf.xyz](https://lexicon.garden/identity/did:plc:jkf4momksftvstbyqnb5sxik)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:jkf4momksftvstbyqnb5sxik/xyz.opnshelf.episode)
- [Documentation](https://lexicon.garden/lexicon/did:plc:jkf4momksftvstbyqnb5sxik/xyz.opnshelf.episode/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:jkf4momksftvstbyqnb5sxik/xyz.opnshelf.episode/examples)

## Definitions

### `xyz.opnshelf.episode`

**Type**: `record`

A tracked show episode record for OpnShelf

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `showId` | `string` | Yes | TMDB show ID |
| `source` | `string` | Yes | Source of the show data (e.g., tmdb) |
| `createdAt` | `string` (datetime) | Yes | Record creation timestamp |
| `watchedAt` | `string` (datetime) | Yes | When the episode was watched |
| `seasonNumber` | `integer` | Yes | TMDB season number |
| `episodeNumber` | `integer` | Yes | TMDB episode number |

## Raw Schema

```json
{
  "id": "xyz.opnshelf.episode",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "showId",
          "seasonNumber",
          "episodeNumber",
          "source",
          "watchedAt",
          "createdAt"
        ],
        "properties": {
          "showId": {
            "type": "string",
            "description": "TMDB show ID"
          },
          "source": {
            "type": "string",
            "description": "Source of the show data (e.g., tmdb)"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Record creation timestamp"
          },
          "watchedAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the episode was watched"
          },
          "seasonNumber": {
            "type": "integer",
            "description": "TMDB season number"
          },
          "episodeNumber": {
            "type": "integer",
            "description": "TMDB episode number"
          }
        }
      },
      "description": "A tracked show episode record for OpnShelf"
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```