# town.laugh.calendar.defs

> Published by [laugh.town](https://lexicon.garden/identity/did:plc:k6owgpe2rkkchoiivxhzp2t4)

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:k6owgpe2rkkchoiivxhzp2t4/town.laugh.calendar.defs)
- [Documentation](https://lexicon.garden/lexicon/did:plc:k6owgpe2rkkchoiivxhzp2t4/town.laugh.calendar.defs/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:k6owgpe2rkkchoiivxhzp2t4/town.laugh.calendar.defs/examples)

## Definitions

### `town.laugh.calendar.defs#eventExtras`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `slug` | `string` | No | URL routing slug (mutable); central-repo records only, derived for user shows |
| `venue` | `string` (at-uri) | Yes | AT-URI reference to the town.laugh.db.venue record |
| `origin` | `string` | No | Where this record came from; central-repo records only |
| `doorsAt` | `string` (datetime) | No | Offset-qualified doors-open datetime, interpreted in the same timezone |
| `roomRef` | `string` (at-uri) | No | AT-URI reference to the town.laugh.db.room record |
| `currency` | `string` | No | ISO 4217 currency code for priceMin/priceMax, e.g. USD; required if either is set |
| `priceMax` | `integer` | No | Highest ticket price in minor units for tiered pricing; same currency |
| `priceMin` | `integer` | No | Lowest ticket price in minor units (e.g. cents); requires currency |
| `timezone` | `string` | Yes | IANA timezone name for startsAt/doorsAt, e.g. America/Los_Angeles |
| `eventType` | `string` | No | Kind of comedy event; absent when unclassified |
| `languages` | `array` | No | BCP-47 languages of the show |
| `sourceUrl` | `string` (uri) | No | Source listing URL |
| `ticketUrl` | `string` (uri) | No | Ticket purchase URL |
| `performers` | `array` | No | Billed performers |
| `presentedBy` | `string` | No | Presenting promoter/organizer |
| `drinkMinimum` | `string` | No | Drink/purchase minimum, e.g. 2-drink minimum |
| `ticketStatus` | `string` | No | Availability label, e.g. Sold Out / 3 left (distinct from lifecycle status) |
| `nameLocalized` | `array` | No | Name in other languages/scripts; name is the canonical fallback |
| `ageRestriction` | `string` | No | Age policy, e.g. 21+ / All Ages |
| `descriptionLocalized` | `array` | No | Localized descriptions, one entry per language; the plain-string description field is the canonical fallback |

## Raw Schema

```json
{
  "id": "town.laugh.calendar.defs",
  "defs": {
    "eventExtras": {
      "type": "object",
      "required": [
        "venue",
        "timezone"
      ],
      "properties": {
        "slug": {
          "type": "string",
          "description": "URL routing slug (mutable); central-repo records only, derived for user shows"
        },
        "venue": {
          "type": "string",
          "format": "at-uri",
          "description": "AT-URI reference to the town.laugh.db.venue record"
        },
        "origin": {
          "type": "string",
          "description": "Where this record came from; central-repo records only",
          "knownValues": [
            "scraped",
            "native",
            "atproto"
          ]
        },
        "doorsAt": {
          "type": "string",
          "format": "datetime",
          "description": "Offset-qualified doors-open datetime, interpreted in the same timezone"
        },
        "roomRef": {
          "type": "string",
          "format": "at-uri",
          "description": "AT-URI reference to the town.laugh.db.room record"
        },
        "currency": {
          "type": "string",
          "description": "ISO 4217 currency code for priceMin/priceMax, e.g. USD; required if either is set"
        },
        "priceMax": {
          "type": "integer",
          "description": "Highest ticket price in minor units for tiered pricing; same currency"
        },
        "priceMin": {
          "type": "integer",
          "description": "Lowest ticket price in minor units (e.g. cents); requires currency"
        },
        "timezone": {
          "type": "string",
          "description": "IANA timezone name for startsAt/doorsAt, e.g. America/Los_Angeles"
        },
        "eventType": {
          "type": "string",
          "description": "Kind of comedy event; absent when unclassified",
          "knownValues": [
            "openMic",
            "showcase",
            "standup",
            "improv",
            "sketch"
          ]
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "language"
          },
          "description": "BCP-47 languages of the show"
        },
        "sourceUrl": {
          "type": "string",
          "format": "uri",
          "description": "Source listing URL"
        },
        "ticketUrl": {
          "type": "string",
          "format": "uri",
          "description": "Ticket purchase URL"
        },
        "performers": {
          "type": "array",
          "items": {
            "ref": "town.laugh.db.defs#performer",
            "type": "ref"
          },
          "description": "Billed performers"
        },
        "presentedBy": {
          "type": "string",
          "description": "Presenting promoter/organizer"
        },
        "drinkMinimum": {
          "type": "string",
          "description": "Drink/purchase minimum, e.g. 2-drink minimum"
        },
        "ticketStatus": {
          "type": "string",
          "description": "Availability label, e.g. Sold Out / 3 left (distinct from lifecycle status)"
        },
        "nameLocalized": {
          "type": "array",
          "items": {
            "ref": "town.laugh.db.defs#localizedText",
            "type": "ref"
          },
          "description": "Name in other languages/scripts; name is the canonical fallback"
        },
        "ageRestriction": {
          "type": "string",
          "description": "Age policy, e.g. 21+ / All Ages"
        },
        "descriptionLocalized": {
          "type": "array",
          "items": {
            "ref": "town.laugh.db.defs#localizedText",
            "type": "ref"
          },
          "description": "Localized descriptions, one entry per language; the plain-string description field is the canonical fallback"
        }
      }
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```
