Traveler
A single, unique representation of a traveler within Traveler Identity Service, serving as the definitive source of truth for traveler identity, attributes, and contextual links across border control solutions.
The Traveler is the root entity to which all documents, journeys, and encounters are linked. All consuming applications reference the same traveler and semantics.
Attributes
| Field | Type | Optionality | Format / Length | Source | Notes |
|---|---|---|---|---|---|
referenceId | UUID / string | Mandatory | 36 chars if UUID | System | Internal stable identifier — not derived from passport or DB primary key |
firstName | string (Unicode) | Mandatory | 1..100 | ICAO / ETIAS | Store normalized VIZ value; do not rely only on MRZ-transliterated form |
middleName | string (Unicode) | Optional | 1..100 | ETIAS / business | Not a passport concept on its own; often part of given names |
lastName | string (Unicode) | Mandatory | 1..100 | ICAO / ETIAS | Passport family name / primary identifier |
dateOfBirth | date | Mandatory | YYYY-MM-DD | ICAO / EES / ETIAS | Store as date, not string; passport MRZ encodes YYMMDD, system normalizes to ISO date |
placeOfBirth | string (Unicode) | Conditional | 1..150 | ICAO / ETIAS | ICAO passport field is optional; not mandatory for pure passport ingestion |
countryOfBirth | ISO 3166-1 alpha-3 | Conditional | exactly 3 | ETIAS-oriented | Separate from free-text place of birth — ETIAS distinguishes place and country contexts |
parentsFirstNames | array / structured | Conditional (ETIAS) | up to 2 × 100 | ETIAS | Not ICAO/passport-native; only required when ETIAS scope applies |
nationality | ISO 3166-1 alpha-3 | Mandatory | exactly 3 | ICAO / EES / ETIAS | ICAO MRZ uses 3-letter code |
otherNationalities | array<ISO 3166-1 alpha-3> | Conditional | 0..n | ETIAS | Future-proof; matches real-world dual / multi-nationality cases |
gender | enum | Mandatory if from passport | M, F, UNKNOWN | ICAO / ETIAS | Note: ICAO passport standard is sex, not gender |
homeAddress | structured object | Conditional (ETIAS) | n/a | ETIAS | Not passport-native; structured (street, city, country) preferred over flat string |
identityStatus | enum | Mandatory | configurable; see Traveler lifecycle | System | Lifecycle field — not ICAO/EES/ETIAS. Reflects the traveler record's current lifecycle stage; the stage set is part of platform configuration delivered with your deployment |
See also
- Data Model overview — full entity set, standards alignment, domain separation
- Document — official travel or identity documents linked to a Traveler
- Journey — Traveler's planned or actual movement on a transport instance
- Encounter — recorded interaction sessions at border touchpoints