Person
ProposedAn individual such as an owner, tenant, council member, or contact. Only include personal information that the exchanging parties are entitled to share.
Fields
| Field | Type | Description |
|---|---|---|
idrequired | Identifier | Stable identifier of this Person record. |
displayNamerequired | string | Name to display. min length 1 · max length 200 |
givenNameoptional | string | Given name. max length 100 |
familyNameoptional | string | Family name. max length 100 |
emailoptional | string | Email address. format: email |
phoneoptional | string | Phone number in E.164 format. pattern: ^\+[1-9][0-9]{6,14}$ |
mailingAddressoptional | Address | Mailing address for notices, if different from the unit address. |
extensionsoptional | Extensions | Implementation-specific data, namespaced by reverse domain. |
Relationships
Validation rules
Cross-field rules beyond what JSON Schema expresses. Documented in the draft; not yet enforced by tooling.
- Implementations must not require email or phone; many exchanges should omit them entirely.
Example payload
Illustrative only, with fictional data. Validated against the draft schema at build time.
{
"id": "person-0001",
"displayName": "Alex Example",
"givenName": "Alex",
"familyName": "Example",
"email": "alex@example.com"
}