Dieses Schema definiert:

Name:

• titles: Optionale Liste von Titeln (z. B. „Dr.“, „Prof.“, „Sir“).
• givenNames: Liste von Vornamen (mindestens ein Name erforderlich).
• familyNames: Liste von Nachnamen oder Familiennamen (mindestens ein Name erforderlich).
• suffixes: Optionale Namenszusätze (z. B. „Jr.“, „III“).
• preferredName: Der bevorzugte vollständige Name der Person.
• birthDate: Geburtsdatum im ISO-8601-Format (YYYY-MM-DD).

birthPlace:

• city: Stadt oder Ort des Geburtsortes.
• state: Optional, Bundesland oder Region.
• country: Länderkürzel nach ISO 3166-1 Alpha-2.

{
  "name": {
    "titles": ["Dr.", "Prof."],
    "givenNames": ["Max", "Karl"],
    "familyNames": ["Mustermann", "von Beispiel"],
    "suffixes": ["Jr."],
    "preferredName": "Dr. Max Mustermann"
  },
  "birthDate": "1990-01-01",
  "birthPlace": {
    "city": "Berlin",
    "state": "Berlin",
    "country": "DE"
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://b2base.eu/doku.php?id=schemes:person:nameandbirthdetails",
  "title": "person:nameandbirthdetails",
  "description": "A schema for representing a person's name, birth date, and birth place.",
  "type": "object",
  "properties": {
    "name": {
      "type": "object",
      "description": "Information about the person's name.",
      "properties": {
        "titles": {
          "type": "array",
          "description": "Optional titles such as Dr., Prof., Sir.",
          "items": {
            "type": "string"
          },
          "example": ["Dr.", "Prof."]
        },
        "givenNames": {
          "type": "array",
          "description": "A list of given names.",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "example": ["Max", "Karl"]
        },
        "familyNames": {
          "type": "array",
          "description": "A list of family or last names.",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "example": ["Mustermann", "von Beispiel"]
        },
        "suffixes": {
          "type": "array",
          "description": "Optional name suffixes such as Jr., Sr., III.",
          "items": {
            "type": "string"
          },
          "example": ["Jr.", "III"]
        },
        "preferredName": {
          "type": "string",
          "description": "The preferred full name of the person.",
          "example": "Dr. Max Mustermann"
        }
      },
      "required": ["givenNames", "familyNames"]
    },
    "birthDate": {
      "type": "string",
      "format": "date",
      "description": "The person's date of birth in YYYY-MM-DD format.",
      "example": "1990-01-01"
    },
    "birthPlace": {
      "type": "object",
      "description": "The person's place of birth.",
      "properties": {
        "city": {
          "type": "string",
          "description": "The name of the city or town.",
          "example": "Berlin"
        },
        "state": {
          "type": "string",
          "description": "The name of the state or region.",
          "example": "Berlin"
        },
        "country": {
          "type": "string",
          "description": "ISO 3166-1 Alpha-2 country code of the birth country.",
          "example": "DE"
        }
      },
      "required": ["city", "country"]
    }
  },
  "required": ["name", "birthDate", "birthPlace"]
}