# town.laugh.db.venue

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

## Definitions

### `town.laugh.db.venue`

**Type**: `record`

A comedy club or venue

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | `string` | Yes | Canonical venue name |
| `slug` | `string` | Yes | URL routing slug (mutable) |
| `type` | `string` | No | Venue type |
| `email` | `string` | No | Email address |
| `phone` | `string` | No | Phone number |
| `origin` | `string` | Yes | Where this record came from |
| `website` | `string` (uri) | No | Venue website |
| `capacity` | `integer` | No | Seating capacity |
| `imageUrl` | `string` (uri) | No | Venue image URL |
| `placeRef` | `string` (uri) | No | Canonical place reference (e.g. an atgeo place URI) when known |
| `typeNote` | `string` | No | Free-text venue type detail, used when type is "other" |
| `wikidata` | `string` | No | Wikidata entity id, e.g. Q12345 |
| `claimedBy` | `string` (did) | No | DID of the owner who has claimed this venue; absent means unclaimed |
| `createdAt` | `string` (datetime) | Yes | Timestamp of record creation |
| `languages` | `array` | No | BCP-47 languages the venue programs |
| `locations` | `array` | No | Geo and address entries; each element conforms to a community.lexicon.location.* sub-lexicon identified by its $type (geo, address, hthree, bbox). |
| `nicknames` | `array` | No | Alternate or former names, common shortenings |
| `wikipedia` | `string` (uri) | No | Wikipedia article URL |
| `yearOpened` | `integer` | No | Year the venue opened |
| `description` | `array` | No | Venue description, one entry per language |
| `externalIds` | `array` | No | External identifiers (social handles, events URL, etc.) |
| `nameLocalized` | `array` | No | Name in other languages/scripts; name is the canonical fallback |
| `imageAttribution` | `string` (uri) | No | Source/attribution URL for the image |

## Raw Schema

```json
{
  "id": "town.laugh.db.venue",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "name",
          "slug",
          "origin",
          "createdAt"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Canonical venue name"
          },
          "slug": {
            "type": "string",
            "description": "URL routing slug (mutable)"
          },
          "type": {
            "type": "string",
            "description": "Venue type",
            "knownValues": [
              "club",
              "bar",
              "theater",
              "arena",
              "coffee_shop",
              "restaurant",
              "festival",
              "online",
              "other"
            ]
          },
          "email": {
            "type": "string",
            "description": "Email address"
          },
          "phone": {
            "type": "string",
            "description": "Phone number"
          },
          "origin": {
            "type": "string",
            "description": "Where this record came from",
            "knownValues": [
              "scraped",
              "native",
              "atproto"
            ]
          },
          "website": {
            "type": "string",
            "format": "uri",
            "description": "Venue website"
          },
          "capacity": {
            "type": "integer",
            "description": "Seating capacity"
          },
          "imageUrl": {
            "type": "string",
            "format": "uri",
            "description": "Venue image URL"
          },
          "placeRef": {
            "type": "string",
            "format": "uri",
            "description": "Canonical place reference (e.g. an atgeo place URI) when known"
          },
          "typeNote": {
            "type": "string",
            "description": "Free-text venue type detail, used when type is \"other\""
          },
          "wikidata": {
            "type": "string",
            "description": "Wikidata entity id, e.g. Q12345"
          },
          "claimedBy": {
            "type": "string",
            "format": "did",
            "description": "DID of the owner who has claimed this venue; absent means unclaimed"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Timestamp of record creation"
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "language"
            },
            "description": "BCP-47 languages the venue programs"
          },
          "locations": {
            "type": "array",
            "items": {
              "type": "unknown"
            },
            "description": "Geo and address entries; each element conforms to a community.lexicon.location.* sub-lexicon identified by its $type (geo, address, hthree, bbox)."
          },
          "nicknames": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Alternate or former names, common shortenings"
          },
          "wikipedia": {
            "type": "string",
            "format": "uri",
            "description": "Wikipedia article URL"
          },
          "yearOpened": {
            "type": "integer",
            "description": "Year the venue opened"
          },
          "description": {
            "type": "array",
            "items": {
              "ref": "town.laugh.db.defs#localizedText",
              "type": "ref"
            },
            "description": "Venue description, one entry per language"
          },
          "externalIds": {
            "type": "array",
            "items": {
              "ref": "town.laugh.db.defs#externalId",
              "type": "ref"
            },
            "description": "External identifiers (social handles, events URL, etc.)"
          },
          "nameLocalized": {
            "type": "array",
            "items": {
              "ref": "town.laugh.db.defs#localizedText",
              "type": "ref"
            },
            "description": "Name in other languages/scripts; name is the canonical fallback"
          },
          "imageAttribution": {
            "type": "string",
            "format": "uri",
            "description": "Source/attribution URL for the image"
          }
        }
      },
      "description": "A comedy club or venue"
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```