# app.beaconbits.pass

> Published by [beaconbits.app](https://lexicon.garden/identity/did:plc:j5ttxzdb5kwo4mcqkmzgvt33)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:j5ttxzdb5kwo4mcqkmzgvt33/app.beaconbits.pass)
- [Documentation](https://lexicon.garden/lexicon/did:plc:j5ttxzdb5kwo4mcqkmzgvt33/app.beaconbits.pass/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:j5ttxzdb5kwo4mcqkmzgvt33/app.beaconbits.pass/examples)

## Definitions

### `app.beaconbits.pass`

**Type**: `record`

A stored pass received from another Beacon Bits user

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `withDid` | `string` (did) | Yes | DID of the other user in the pass exchange |
| `passedAt` | `string` (datetime) | Yes | Timestamp when the pass exchange occurred |
| `venueUri` | `string` | Yes | Venue where the pass exchange happened |
| `createdAt` | `string` (datetime) | Yes | Timestamp when the pass record was written |
| `eventSlug` | `string` | No | Optional event identifier associated with the pass |
| `venueName` | `string` | Yes | Venue display name captured at pass time |
| `receivedCard` | `object` | Yes |  |
| `fragmentReceived` | `string` | No | Optional fragment identifier awarded during the pass |

## Raw Schema

```json
{
  "id": "app.beaconbits.pass",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "withDid",
          "venueUri",
          "venueName",
          "receivedCard",
          "passedAt",
          "createdAt"
        ],
        "properties": {
          "withDid": {
            "type": "string",
            "format": "did",
            "description": "DID of the other user in the pass exchange"
          },
          "passedAt": {
            "type": "string",
            "format": "datetime",
            "description": "Timestamp when the pass exchange occurred"
          },
          "venueUri": {
            "type": "string",
            "description": "Venue where the pass exchange happened"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Timestamp when the pass record was written"
          },
          "eventSlug": {
            "type": "string",
            "description": "Optional event identifier associated with the pass",
            "maxGraphemes": 128
          },
          "venueName": {
            "type": "string",
            "description": "Venue display name captured at pass time",
            "maxGraphemes": 128
          },
          "receivedCard": {
            "type": "object",
            "required": [
              "handle"
            ],
            "properties": {
              "handle": {
                "type": "string",
                "description": "Handle snapshot captured from the other user at pass time",
                "maxGraphemes": 256
              }
            }
          },
          "fragmentReceived": {
            "type": "string",
            "description": "Optional fragment identifier awarded during the pass",
            "maxGraphemes": 128
          }
        }
      },
      "description": "A stored pass received from another Beacon Bits user"
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```
