# social.passports.foursquare.checkin

> Published by [passports.social](https://lexicon.garden/identity/did:plc:ssdgllkzfwekkpmu7expw6cv)

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:ssdgllkzfwekkpmu7expw6cv/social.passports.foursquare.checkin)
- [Documentation](https://lexicon.garden/lexicon/did:plc:ssdgllkzfwekkpmu7expw6cv/social.passports.foursquare.checkin/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:ssdgllkzfwekkpmu7expw6cv/social.passports.foursquare.checkin/examples)

## Definitions

### `social.passports.foursquare.checkin`

**Type**: `object`

Foursquare/Swarm check-in metadata. Intended to be embedded within an app.beaconbits.beacon record as the 'foursquare' property, carrying fields that the beacon lexicon does not define — check-in ID, city, state, country, and photo. Consumers that only understand app.beaconbits.beacon will ignore this object.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `venueId` | `string` | Yes | Foursquare venue ID. Combined with the top-level venueUri, which is constructed as https://foursquare.com/venue/{venueId}. |
| `photoUrl` | `string` (uri) | No | URL to the check-in photo, if one was attached. Foursquare CDN URL in original size. |
| `checkinId` | `string` | Yes | Original Foursquare check-in ID. Used for deduplication and linking back to the source check-in. |
| `venueCity` | `string` | No | City where the venue is located. |
| `venueState` | `string` | No | State or region where the venue is located. |
| `venueCountry` | `string` | No | ISO 3166-1 alpha-2 country code, e.g. 'US'. |

## Raw Schema

```json
{
  "id": "social.passports.foursquare.checkin",
  "defs": {
    "main": {
      "type": "object",
      "required": [
        "checkinId",
        "venueId"
      ],
      "properties": {
        "venueId": {
          "type": "string",
          "maxLength": 64,
          "description": "Foursquare venue ID. Combined with the top-level venueUri, which is constructed as https://foursquare.com/venue/{venueId}."
        },
        "photoUrl": {
          "type": "string",
          "format": "uri",
          "description": "URL to the check-in photo, if one was attached. Foursquare CDN URL in original size."
        },
        "checkinId": {
          "type": "string",
          "maxLength": 64,
          "description": "Original Foursquare check-in ID. Used for deduplication and linking back to the source check-in."
        },
        "venueCity": {
          "type": "string",
          "maxLength": 100,
          "description": "City where the venue is located."
        },
        "venueState": {
          "type": "string",
          "maxLength": 100,
          "description": "State or region where the venue is located."
        },
        "venueCountry": {
          "type": "string",
          "maxLength": 2,
          "description": "ISO 3166-1 alpha-2 country code, e.g. 'US'."
        }
      },
      "description": "Foursquare/Swarm check-in metadata. Intended to be embedded within an app.beaconbits.beacon record as the 'foursquare' property, carrying fields that the beacon lexicon does not define — check-in ID, city, state, country, and photo. Consumers that only understand app.beaconbits.beacon will ignore this object."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```