social.passports.tickets.stub

passports.social

Documentation

A ticket stub — a record of attending a live event, performance, screening, or exhibition. Only public stubs are written to the PDS.

main record

A ticket stub — a record of attending a live event, performance, screening, or exhibition. Only public stubs are written to the PDS.

Record Key tid Timestamp-based ID

Properties

category string Optional

Event category.

Known values: Concert, Musical/Broadway, Theater/Play, Opera, Dance/Ballet, Comedy, Movie/Film, Sports, Festival, Museum/Exhibition, Conference/Convention, Circus/Variety, Theme Park, Other
createdAt string datetime Required

Timestamp when the stub record was created.

image blob Optional

Photo of the physical ticket stub, uploaded as a blob to the user's PDS.

maxSize: 10.5 MB
stubDate string Optional

Date of the event in YYYY-MM-DD format. Nullable — user may not know the exact date.

maxLength: 10 bytes
text string Optional

Free-form text associated with the stub — OCR-extracted from a ticket scan, manually entered, or both.

maxLength: 10000 bytes
title string Required

Name of the event, show, or film.

maxLength: 300 bytes
unlocode string Optional

UN/LOCODE for the venue city, e.g. 'US NYC'. Drives city and country display.

maxLength: 6 bytes
venueCity string Optional

City where the event took place.

maxLength: 100 bytes
venueCountry string Optional

ISO 3166-1 alpha-2 country code, e.g. 'US'.

maxLength: 2 bytes
venueName string Optional

Name of the venue, e.g. 'Madison Square Garden'.

maxLength: 300 bytes
View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "title",
      "createdAt"
    ],
    "properties": {
      "text": {
        "type": "string",
        "maxLength": 10000,
        "description": "Free-form text associated with the stub — OCR-extracted from a ticket scan, manually entered, or both."
      },
      "image": {
        "type": "blob",
        "accept": [
          "image/jpeg",
          "image/png",
          "image/webp",
          "image/gif",
          "image/heic"
        ],
        "maxSize": 10485760,
        "description": "Photo of the physical ticket stub, uploaded as a blob to the user's PDS."
      },
      "title": {
        "type": "string",
        "maxLength": 300,
        "description": "Name of the event, show, or film."
      },
      "category": {
        "type": "string",
        "description": "Event category.",
        "knownValues": [
          "Concert",
          "Musical/Broadway",
          "Theater/Play",
          "Opera",
          "Dance/Ballet",
          "Comedy",
          "Movie/Film",
          "Sports",
          "Festival",
          "Museum/Exhibition",
          "Conference/Convention",
          "Circus/Variety",
          "Theme Park",
          "Other"
        ]
      },
      "stubDate": {
        "type": "string",
        "maxLength": 10,
        "description": "Date of the event in YYYY-MM-DD format. Nullable — user may not know the exact date."
      },
      "unlocode": {
        "type": "string",
        "maxLength": 6,
        "description": "UN/LOCODE for the venue city, e.g. 'US NYC'. Drives city and country display."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Timestamp when the stub record was created."
      },
      "venueCity": {
        "type": "string",
        "maxLength": 100,
        "description": "City where the event took place."
      },
      "venueName": {
        "type": "string",
        "maxLength": 300,
        "description": "Name of the venue, e.g. 'Madison Square Garden'."
      },
      "venueCountry": {
        "type": "string",
        "maxLength": 2,
        "description": "ISO 3166-1 alpha-2 country code, e.g. 'US'."
      }
    }
  },
  "description": "A ticket stub — a record of attending a live event, performance, screening, or exhibition. Only public stubs are written to the PDS."
}

Lexicon Garden

@