{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/august-health/json-schema/august-health-com-august-api-integrations-models-contacts-v1-contact-schema.json",
  "title": "com.august.api.integrations.models.contacts.v1.Contact",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/august-health-contacts-v1-api-openapi.yml#/components/schemas/com.august.api.integrations.models.contacts.v1.Contact",
  "properties": {
    "address": {
      "$ref": "#/$defs/com.august.api.integrations.models.common_metadata.v1.Address"
    },
    "clinicalSpecialty": {
      "type": "string"
    },
    "externalFields": {
      "$ref": "#/$defs/com.august.api.integrations.models.contacts.v1.ExternalFields"
    },
    "id": {
      "type": "string"
    },
    "name": {
      "$ref": "#/$defs/com.august.api.integrations.models.common_metadata.v1.HumanName"
    },
    "note": {
      "type": "string"
    },
    "organization": {
      "$ref": "#/$defs/com.august.api.integrations.models.contacts.v1.GenericOrganization"
    },
    "relationship": {
      "items": {
        "$ref": "#/$defs/com.august.protos.contact.Contact.ContactRelationship"
      },
      "type": "array"
    },
    "telecom": {
      "items": {
        "$ref": "#/$defs/com.august.api.integrations.models.contacts.v1.ContactPoint"
      },
      "type": "array"
    }
  },
  "required": [
    "id",
    "relationship",
    "name",
    "telecom"
  ],
  "$defs": {
    "com.august.api.integrations.models.common_metadata.v1.Address": {
      "properties": {
        "city": {
          "type": "string"
        },
        "line": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "postalCode": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "text": {
          "type": "string"
        },
        "use": {
          "$ref": "#/$defs/com.august.protos.address.Address.AddressUse"
        }
      },
      "required": [
        "line"
      ]
    },
    "com.august.api.integrations.models.common_metadata.v1.HumanName": {
      "properties": {
        "family": {
          "type": "string"
        },
        "given": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "maiden": {
          "type": "string"
        },
        "preferredName": {
          "type": "string"
        },
        "prefix": {
          "type": "string"
        },
        "pronouns": {
          "$ref": "#/$defs/com.august.protos.human_name.HumanName.Pronouns"
        },
        "suffix": {
          "type": "string"
        }
      },
      "required": [
        "given"
      ]
    },
    "com.august.api.integrations.models.contacts.v1.ContactPoint": {
      "properties": {
        "rank": {
          "format": "int32",
          "type": "integer"
        },
        "system": {
          "$ref": "#/$defs/com.august.protos.contact_point.ContactPoint.ContactPointSystem"
        },
        "use": {
          "$ref": "#/$defs/com.august.protos.contact_point.ContactPoint.ContactPointUse"
        },
        "value": {
          "type": "string"
        }
      },
      "required": [
        "system",
        "use"
      ]
    },
    "com.august.api.integrations.models.contacts.v1.ExternalFields": {
      "properties": {
        "yardi": {
          "$ref": "#/$defs/com.august.api.integrations.models.contacts.v1.YardiFields"
        }
      }
    },
    "com.august.api.integrations.models.contacts.v1.GenericOrganization": {
      "properties": {
        "address": {
          "items": {
            "$ref": "#/$defs/com.august.api.integrations.models.common_metadata.v1.Address"
          },
          "type": "array"
        },
        "contact": {
          "items": {
            "$ref": "#/$defs/com.august.api.integrations.models.contacts.v1.GenericOrganizationContact"
          },
          "type": "array"
        },
        "name": {
          "type": "string"
        },
        "telecom": {
          "items": {
            "$ref": "#/$defs/com.august.api.integrations.models.contacts.v1.ContactPoint"
          },
          "type": "array"
        }
      },
      "required": [
        "telecom",
        "address",
        "contact"
      ]
    },
    "com.august.api.integrations.models.contacts.v1.GenericOrganizationContact": {
      "properties": {
        "address": {
          "$ref": "#/$defs/com.august.api.integrations.models.common_metadata.v1.Address"
        },
        "name": {
          "$ref": "#/$defs/com.august.api.integrations.models.common_metadata.v1.HumanName"
        },
        "telecom": {
          "items": {
            "$ref": "#/$defs/com.august.api.integrations.models.contacts.v1.ContactPoint"
          },
          "type": "array"
        }
      },
      "required": [
        "telecom"
      ]
    },
    "com.august.api.integrations.models.contacts.v1.YardiFields": {
      "properties": {
        "extRefId": {
          "type": "string"
        }
      }
    },
    "com.august.protos.address.Address.AddressUse": {
      "enum": [
        "ADDRESS_USE_HOME",
        "ADDRESS_USE_WORK",
        "ADDRESS_USE_TEMP",
        "ADDRESS_USE_OLD",
        "ADDRESS_USE_BILLING"
      ],
      "type": "string"
    },
    "com.august.protos.contact.Contact.ContactRelationship": {
      "enum": [
        "CONTACT_RELATIONSHIP_PERSONAL",
        "CONTACT_RELATIONSHIP_FAMMEMB",
        "CONTACT_RELATIONSHIP_CHILD",
        "CONTACT_RELATIONSHIP_GRNDCHILD",
        "CONTACT_RELATIONSHIP_SPS",
        "CONTACT_RELATIONSHIP_SIB",
        "CONTACT_RELATIONSHIP_NIENEPH",
        "CONTACT_RELATIONSHIP_GRNIENEPH",
        "CONTACT_RELATIONSHIP_COUSN",
        "CONTACT_RELATIONSHIP_FRND",
        "CONTACT_RELATIONSHIP_CHILD_INLAW",
        "CONTACT_RELATIONSHIP_CLINICIAN",
        "CONTACT_RELATIONSHIP_PHYSICIAN",
        "CONTACT_RELATIONSHIP_NURSE_PRACTITIONER",
        "CONTACT_RELATIONSHIP_PHYSICIAN_ASSISTANT",
        "CONTACT_RELATIONSHIP_PHARMACIST",
        "CONTACT_RELATIONSHIP_NURSE",
        "CONTACT_RELATIONSHIP_SKILLED_THERAPIST",
        "CONTACT_RELATIONSHIP_PSYCHOLOGIST",
        "CONTACT_RELATIONSHIP_DIETICIAN",
        "CONTACT_RELATIONSHIP_SOCIAL_WORKER",
        "CONTACT_RELATIONSHIP_DENTIST",
        "CONTACT_RELATIONSHIP_PODIATRIST",
        "CONTACT_RELATIONSHIP_PROFESSIONAL",
        "CONTACT_RELATIONSHIP_REFERRAL_AGENT",
        "CONTACT_RELATIONSHIP_PLACEMENT_AGENT",
        "CONTACT_RELATIONSHIP_CONSERVATOR",
        "CONTACT_RELATIONSHIP_LEGALLY_RESPONSIBLE",
        "CONTACT_RELATIONSHIP_CASE_MANAGER",
        "CONTACT_RELATIONSHIP_RELIGIOUS_ADVISOR",
        "CONTACT_RELATIONSHIP_THIRD_PARTY_PAYER",
        "CONTACT_RELATIONSHIP_FIDUCIARY",
        "CONTACT_RELATIONSHIP_FUNERAL_HOME",
        "CONTACT_RELATIONSHIP_VETERINARIAN",
        "CONTACT_RELATIONSHIP_GENERAL_PRACTITIONER",
        "CONTACT_RELATIONSHIP_MENTAL_HEALTH_PROVIDER",
        "CONTACT_RELATIONSHIP_HOSPICE_PROVIDER",
        "CONTACT_RELATIONSHIP_RESPONSIBLE_PERSON",
        "CONTACT_RELATIONSHIP_FINANCIAL_PAYMENT_OF_CARE",
        "CONTACT_RELATIONSHIP_FINANCIAL_POWER_OF_ATTORNEY",
        "CONTACT_RELATIONSHIP_MEDICAL_POWER_OF_ATTORNEY",
        "CONTACT_RELATIONSHIP_C",
        "CONTACT_RELATIONSHIP_FORM_CONTRIBUTOR",
        "CONTACT_RELATIONSHIP_RELEASE_OF_INFORMATION",
        "CONTACT_RELATIONSHIP_PERSONAL_PROPERTY",
        "CONTACT_RELATIONSHIP_OTHER",
        "CONTACT_RELATIONSHIP_SELF",
        "CONTACT_RELATIONSHIP_N"
      ],
      "type": "string"
    },
    "com.august.protos.contact_point.ContactPoint.ContactPointSystem": {
      "enum": [
        "CONTACT_POINT_SYSTEM_PHONE",
        "CONTACT_POINT_SYSTEM_FAX",
        "CONTACT_POINT_SYSTEM_EMAIL"
      ],
      "type": "string"
    },
    "com.august.protos.contact_point.ContactPoint.ContactPointUse": {
      "enum": [
        "CONTACT_POINT_USE_HOME",
        "CONTACT_POINT_USE_WORK",
        "CONTACT_POINT_USE_MOBILE",
        "CONTACT_POINT_USE_PAGER",
        "CONTACT_POINT_USE_EMERGENCY"
      ],
      "type": "string"
    },
    "com.august.protos.human_name.HumanName.Pronouns": {
      "enum": [
        "PRONOUNS_SHE_HER",
        "PRONOUNS_HE_HIM",
        "PRONOUNS_THEY_THEM",
        "PRONOUNS_SHE_THEY",
        "PRONOUNS_HE_THEY",
        "PRONOUNS_ZE_HIR"
      ],
      "type": "string"
    }
  }
}