Individual

Extends

Party

Individual represents a single human being (a man, woman or child). The individual can be a customer, an employee or any other person that the organization needs to store information about.

Field Required Nullable Type Description Constraints Example

@type

Yes

No

String

When sub-classing, this defines the sub-class Extensible name

@baseType

No

No

String

When sub-classing, this defines the super-class

@schemaLocation

No

No

String

A URI to a JSON-Schema file that defines additional attributes and relationships

id

No

No

String

Unique identifier

2d7ed5fd-9f62-4211-bc84-357f5f7b80f5

href

No

No

URI

Hyperlink reference

https://api.example.org/resource/id

contactMedium

No

No

array of ContactMedium

List of means for contacting the party, e.g. mobile phone, email address

[]

externalReference

No

No

array of ExternalIdentifier

List of identifiers of the Party in an external system, for example when party information is imported from a commerce system

[]

businessId

No

No

String

A business relevant identifier when different from the technical identifier documented with the .id property

1234

partyCharacteristic

No

No

array of Characteristic

List of additional characteristics that a Party can take on.

[]

familyName

No

No

String

Contains the non-chosen or inherited name. Also known as last name in the Western context

Muster

salutation

No

No

String

Standard wording used to address an individual

Ms

givenName

No

No

String

First name of the individual

Melanie

title

No

No

String

Useful for titles (aristocratic, social,…​) Pr, Dr, Sir, …​

Dr.