{
  "$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-billing-summary-v1-external-billing-summary-schema.json",
  "title": "com.august.api.integrations.models.billing_summary.v1.ExternalBillingSummary",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/august-health-billing-v1-api-openapi.yml#/components/schemas/com.august.api.integrations.models.billing_summary.v1.ExternalBillingSummary",
  "properties": {
    "contacts": {
      "description": "Contacts who are payers or responsible parties",
      "items": {
        "$ref": "#/$defs/com.august.api.integrations.models.billing_summary.v1.ExternalContact",
        "description": "Contacts who are payers or responsible parties"
      },
      "type": "array"
    },
    "currentBalanceCents": {
      "description": "Total current balance in cents",
      "format": "int32",
      "type": "integer"
    },
    "financialMoveInDate": {
      "format": "date",
      "type": "string"
    },
    "financialMoveOutDate": {
      "format": "date",
      "type": "string"
    },
    "firstName": {
      "description": "Resident's first name (first given name)",
      "type": "string"
    },
    "lastName": {
      "description": "Resident's last name (family name)",
      "type": "string"
    },
    "latestStatement": {
      "$ref": "#/$defs/com.august.api.integrations.models.billing_summary.v1.LatestStatement",
      "description": "Most recent issued statement details (null if no statements)"
    },
    "physicalMoveInDate": {
      "format": "date",
      "type": "string"
    },
    "physicalMoveOutDate": {
      "format": "date",
      "type": "string"
    },
    "residentId": {
      "type": "string"
    },
    "residentStatus": {
      "$ref": "#/$defs/com.august.protos.person.ResidentStatus",
      "description": "Current resident status"
    }
  },
  "required": [
    "residentId",
    "residentStatus",
    "currentBalanceCents",
    "contacts"
  ],
  "$defs": {
    "com.august.api.integrations.models.billing_summary.v1.ExternalContact": {
      "properties": {
        "email": {
          "description": "Primary email address",
          "type": "string"
        },
        "firstName": {
          "description": "Contact's first name (first given name)",
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "isPayer": {
          "description": "True if contact is marked as \"Payment of Care\"",
          "type": "boolean"
        },
        "isResponsibleParty": {
          "description": "True if contact is marked as \"Responsible Person\"",
          "type": "boolean"
        },
        "isSelf": {
          "description": "True if contact represents the resident themselves",
          "type": "boolean"
        },
        "lastName": {
          "description": "Contact's last name (family name)",
          "type": "string"
        },
        "phone": {
          "description": "Primary phone number",
          "type": "string"
        }
      },
      "required": [
        "id",
        "isPayer",
        "isResponsibleParty",
        "isSelf"
      ]
    },
    "com.august.api.integrations.models.billing_summary.v1.LatestStatement": {
      "properties": {
        "balanceCents": {
          "description": "Remaining balance on this statement in cents (after payments)",
          "format": "int32",
          "type": "integer"
        },
        "dueDate": {
          "format": "date",
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "issueDate": {
          "format": "date",
          "type": "string"
        }
      },
      "required": [
        "id",
        "issueDate",
        "dueDate",
        "balanceCents"
      ]
    },
    "com.august.protos.person.ResidentStatus": {
      "enum": [
        "RESIDENT_STATUS_PROSPECT",
        "RESIDENT_STATUS_CURRENT_RESIDENT",
        "RESIDENT_STATUS_CLOSED",
        "RESIDENT_STATUS_DISCHARGED",
        "RESIDENT_STATUS_ENTERED_IN_ERROR"
      ],
      "type": "string"
    }
  }
}