Person

An individual person - the base entity for representing human beings in any business context

18 properties

Schema

Properties

Property	Type	Mode	Description	Required
prefix	string	stored	Title or honorific (Mr., Mrs., Ms., Dr., Prof., etc.) Example: `"Dr."`	Optional
givenName	string	stored	First name or given name Example: `"John"`	Required
middleName	string	stored	Middle name(s) Example: `"Michael"`	Optional
familyName	string	stored	Last name or family name Example: `"Doe"`	Required
suffix	string	stored	Name suffix (Jr., Sr., III, PhD, MD, etc.) Example: `"Jr."`	Optional
preferredName	string	stored	Name the person prefers to be called Example: `"Johnny"`	Optional
status	string	enum	Current status Values: `active, inactive, deceased` Example: `"active"`	Optional
gender	Gender	stored	Gender identity (reference to Gender entity)	Optional
maritalStatus	MaritalStatus	stored	Marital status (reference to MaritalStatus entity)	Optional
birthDate	Date	stored	Date of birth Example: `"1990-01-15"`	Optional
nationality	Country[]	stored	Nationality or citizenship - supports multiple nationalities (reference to Country entity)	Optional
languages	LanguageProficiency[]	stored	Languages spoken by the person with proficiency levels	Optional
telecoms	ContactPoint[]	stored	Contact points - phone numbers, emails, etc.	Optional
onlinePresence	OnlinePresence[]	stored	Online profiles and social media	Optional
address	PostalAddress[]	stored	Physical addresses	Optional
photoUrl	string	stored	URL to person's photograph or avatar Example: `"https://example.com/photos/person.jpg"`	Optional
identifier	Identifier[]	stored	Official identifiers - national ID, passport, driver's license, etc.	Optional
metadata	object	stored	Additional metadata for extensibility	Optional

Examples

Example 1

{
  "@type": "Person",
  "prefix": "Dr.",
  "givenName": "Jane",
  "middleName": "Marie",
  "familyName": "Smith",
  "suffix": "PhD",
  "preferredName": "Jane",
  "status": "active",
  "gender": {
    "@type": "Gender",
    "code": "F",
    "label": "Female"
  },
  "birthDate": "1985-03-20",
  "telecoms": [
    {
      "@type": "ContactPoint",
      "system": "email",
      "value": "jane.smith@example.com",
      "use": "home",
      "rank": 1
    },
    {
      "@type": "ContactPoint",
      "system": "phone",
      "value": "+1-555-0999",
      "use": "mobile"
    }
  ],
  "address": [
    {
      "@type": "PostalAddress",
      "use": "home",
      "streetAddress": "123 Oak Street",
      "addressLocality": "Boston",
      "addressRegion": "MA",
      "postalCode": "02115",
      "addressCountry": "US"
    }
  ],
  "photoUrl": "https://example.com/photos/jane-smith.jpg"
}