# town.laugh.db.event

> 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.db.event)
- [Documentation](https://lexicon.garden/lexicon/did:plc:k6owgpe2rkkchoiivxhzp2t4/town.laugh.db.event/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:k6owgpe2rkkchoiivxhzp2t4/town.laugh.db.event/examples)

## Definitions

### `town.laugh.db.event`

**Type**: `record`

A comedy show at a venue

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `slug` | `string` | Yes | URL routing slug (mutable) |
| `title` | `string` | Yes | Canonical event title |
| `venue` | `string` (at-uri) | Yes | AT-URI reference to the town.laugh.db.venue record |
| `isFree` | `boolean` | No | Whether entry is free |
| `origin` | `string` | Yes | Where this record came from |
| `poster` | `string` (uri) | No | Event flyer/poster image URL |
| `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 |
| `startAt` | `string` (datetime) | Yes | Offset-qualified RFC-3339 start datetime; combine with timezone for Temporal.ZonedDateTime |
| `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 startAt/doorsAt, e.g. America/Los_Angeles |
| `createdAt` | `string` (datetime) | Yes | Timestamp of record creation |
| `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 |
| `description` | `array` | No | Event description, one entry per language |
| `posterWidth` | `integer` | No | Poster image width in pixels |
| `presentedBy` | `string` | No | Presenting promoter/organizer |
| `drinkMinimum` | `string` | No | Drink/purchase minimum, e.g. 2-drink minimum |
| `posterHeight` | `integer` | No | Poster image height in pixels |
| `ticketStatus` | `string` | No | Availability label, e.g. Sold Out / 3 left |
| `ageRestriction` | `string` | No | Age policy, e.g. 21+ / All Ages |
| `titleLocalized` | `array` | No | Title in other languages/scripts; title is the canonical fallback |

## Raw Schema

```json
{
  "id": "town.laugh.db.event",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "venue",
          "slug",
          "title",
          "startAt",
          "timezone",
          "origin",
          "createdAt"
        ],
        "properties": {
          "slug": {
            "type": "string",
            "description": "URL routing slug (mutable)"
          },
          "title": {
            "type": "string",
            "description": "Canonical event title"
          },
          "venue": {
            "type": "string",
            "format": "at-uri",
            "description": "AT-URI reference to the town.laugh.db.venue record"
          },
          "isFree": {
            "type": "boolean",
            "description": "Whether entry is free"
          },
          "origin": {
            "type": "string",
            "description": "Where this record came from",
            "knownValues": [
              "scraped",
              "native",
              "atproto"
            ]
          },
          "poster": {
            "type": "string",
            "format": "uri",
            "description": "Event flyer/poster image URL"
          },
          "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"
          },
          "startAt": {
            "type": "string",
            "format": "datetime",
            "description": "Offset-qualified RFC-3339 start datetime; combine with timezone for Temporal.ZonedDateTime"
          },
          "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 startAt/doorsAt, e.g. America/Los_Angeles"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Timestamp of record creation"
          },
          "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"
          },
          "description": {
            "type": "array",
            "items": {
              "ref": "town.laugh.db.defs#localizedText",
              "type": "ref"
            },
            "description": "Event description, one entry per language"
          },
          "posterWidth": {
            "type": "integer",
            "description": "Poster image width in pixels"
          },
          "presentedBy": {
            "type": "string",
            "description": "Presenting promoter/organizer"
          },
          "drinkMinimum": {
            "type": "string",
            "description": "Drink/purchase minimum, e.g. 2-drink minimum"
          },
          "posterHeight": {
            "type": "integer",
            "description": "Poster image height in pixels"
          },
          "ticketStatus": {
            "type": "string",
            "description": "Availability label, e.g. Sold Out / 3 left"
          },
          "ageRestriction": {
            "type": "string",
            "description": "Age policy, e.g. 21+ / All Ages"
          },
          "titleLocalized": {
            "type": "array",
            "items": {
              "ref": "town.laugh.db.defs#localizedText",
              "type": "ref"
            },
            "description": "Title in other languages/scripts; title is the canonical fallback"
          }
        }
      },
      "description": "A comedy show at a venue"
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```