social.passports.fiftyStates.visit Documentation (EN)

main record

A visit to a US state or territory. Records the subdivision visited and optionally the city and date.

Record Key tid Timestamp-based ID

Properties

city string Required

City visited within the subdivision.

maxLength: 100 bytes

createdAt string datetime Required

An RFC 3339 formatted timestamp.

note string Optional

Free-text notes about this visit.

maxLength: 3000 bytes

subdivision string Required

ISO 3166-2 subdivision code, e.g. 'US-CA', 'US-NY', 'US-HI'.

maxLength: 6 bytes

visitedAt string Optional

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

maxLength: 10 bytes

View raw schema

{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "subdivision",
      "city",
      "createdAt"
    ],
    "properties": {
      "city": {
        "type": "string",
        "maxLength": 100,
        "description": "City visited within the subdivision."
      },
      "note": {
        "type": "string",
        "maxLength": 3000,
        "description": "Free-text notes about this visit."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      },
      "visitedAt": {
        "type": "string",
        "maxLength": 10,
        "description": "Date of visit in YYYY-MM-DD format. Nullable — user may not know the exact date."
      },
      "subdivision": {
        "type": "string",
        "maxLength": 6,
        "description": "ISO 3166-2 subdivision code, e.g. 'US-CA', 'US-NY', 'US-HI'."
      }
    }
  },
  "description": "A visit to a US state or territory. Records the subdivision visited and optionally the city and date."
}