Skip to content

HumanName

A human name with structured components. Adapted for insurance industry use (e.g., professional designations like CPCU, ARM, CIC).

Structure

NameCard.TypeDescription
RHumanNameA human name with structured components.
use0..1official | usual | nickname | maiden | old | anonymousContext in which this name is used
text0..1stringFull text representation of the name (e.g., "John A.
family0..1stringSurname / family name
[ ]given0..*string[]Given names (first name, middle names)
[ ]prefix0..*string[]Name prefixes (Mr., Dr., etc.)
[ ]suffix0..*string[]Name suffixes and professional designations (Jr., CPCU, ARM, CIC)
period0..1PeriodPeriod during which this name was/is in use

Example

json
{
  "use": "official",
  "text": "John A. Smith, CPCU",
  "family": "Smith",
  "given": [
    "John",
    "Andrew"
  ],
  "suffix": [
    "CPCU"
  ]
}

JSON Schema

Full JSON Schema: HumanName.schema.json