Person - Docs

Example

{
  "type": "string",
  "affiliation": [
    "https://example.com/profile/card#me"
  ],
  "address": [
    {
      "type": "PostalAddress",
      "streetAddress": "1007 Mountain Gate Rd",
      "postOfficeBoxNumber": "Box 1234",
      "addressRegion": "NJ",
      "addressLocality": "Gotham City",
      "postalCode": "10010",
      "addressCountry": "CA",
      "addressCounty": "string",
      "addressSubdivision": "Gotham Heights"
    }
  ],
  "birthDate": "2019-08-24",
  "contactPoint": [
    {
      "type": "ContactPoint",
      "name": "Work",
      "telephone": "555-555-5555",
      "faxNumber": "555-555-5555",
      "email": "bob@example.com",
      "url": "https://www.facebook.com/hallandoates"
    }
  ],
  "email": "user@example.com",
  "additionalName": "Johnny,John",
  "familyName": "Smith",
  "faxNumber": "string",
  "givenName": "John",
  "honorificPrefix": "Dr",
  "honorificSuffix": "Esq",
  "jobTitle": [
    "Chief Data Officer",
    "Sanitation Engineer"
  ],
  "knowsLanguage": [
    {
      "type": "Language",
      "name": "English",
      "additionalName": "en-us"
    }
  ],
  "name": "string",
  "telephone": "+15558675309",
  "worksFor": "string"
}

Schema

Name	Type	Description
(root)	object	-
type	string	-
affiliation	array<string>	An organization that this person is affiliated with
affiliation (single item)	string	format (`uri`)
address	array<object>	-
address.type	string	const (`"PostalAddress"`)
address.streetAddress	string	the street address <= 75 characters
address.postOfficeBoxNumber	string	The post office box number for PO box addresses.
address.addressRegion	string	abbreviated state or province
address.addressLocality	string	City, Township. <= 50 characters
address.postalCode	string	Zip/Post Code <= 12 characters
address.addressCountry	string	allowed (`"CA"`, `"DE"`, `"GR"`, `"IN"`, `"IT"`, `"MX"`, `"PE"`, `"PT"`, `"ES"`, `"AE"`, `"GB"`, `"US"`) two-letter ISO 3166-1 alpha-2 country code
address.addressCounty	string	County
address.addressSubdivision	string	the subdivision or neighborhood (us real estate extension)
birthDate	string	date of birth. format (`date`)
contactPoint	array<object>	contact points for the person
contactPoint.type	string	const (`"ContactPoint"`)
contactPoint.name	string	a label for the contactPoint, i.e. 'Work', or 'Home'
contactPoint.telephone	string	-
contactPoint.faxNumber	string	-
contactPoint.email	string	an email address for the item. format (`email`)
contactPoint.url	string	primary URL for the item. format (`uri`)
email	string	a valid email address format (`email`)
additionalName	string	any other name(s) associated with the entity, i.e. nickname, middle name, maiden name, etc. For multiple names, use a comma without space as a separator.
familyName	string	Last Name of a person. Family Name <= 50 characters
faxNumber	string	Do people still use fax machines?
givenName	string	First Name of a person
honorificPrefix	string	An honorific prefix preceding a Person's name such as Dr/Mrs/Mr.
honorificSuffix	string	An honorific title following a person's name like M.D.
jobTitle	array<string>	job tiles associated with the item
jobTitle (single item)	string	-
knowsLanguage	array<object>	languages spoken by the person
knowsLanguage.type	string	const (`"Language"`)
knowsLanguage.name	string	the display name of the language
knowsLanguage.additionalName	string	BCP 47 language code
name	string	Full name of the person.
telephone	string	Primary phone number.
worksFor	string	Organizations the person works for.