Application
application.iduuidapplication.programsAppliedFor[]enumsnap medicaid chip tanfsnap medicaid tanf chipReasonDetermines which eligibility rules to apply and drives federal and state reporting.
application.channelenumonline in_person phone mailsnap medicaid tanfReasonHow the application was filed; used for intake channel reporting and to route applications to appropriate processing queues.
application.ebtEbtapplication.ebt.needsCardbooleanReasonCollected at intake to trigger EBT card issuance at approval without a separate request.
application.ebt.deliveryPreferenceenumby_mail in_personReasonDetermines whether the EBT card is mailed or held for in-person pickup.
application.registerToVotebooleansnap medicaid tanf chipReasonPublic benefits agencies are required to offer voter registration to applicants.
application.deniesIevsConsentbooleanProgramssnap
ReasonApplicants may opt out of income and asset verification against federal data sources. Denial does not disqualify but triggers manual verification.
application.expeditedSnapExpeditedSnapProgramssnap
application.expeditedSnap.totalMoneyExpectedThisMonthnumberProgramssnap
ReasonGross monthly income is compared against the expedited SNAP threshold to determine whether same-day issuance is required.
application.expeditedSnap.totalCashOnHandnumberProgramssnap
ReasonCash and liquid assets are combined with income for the expedited SNAP screening test.
application.expeditedSnap.monthlyMortgagenumberProgramssnap
ReasonMonthly shelter costs are compared against income and cash for the expedited SNAP destitution test.
application.expeditedSnap.monthlyRentnumberProgramssnap
ReasonMonthly shelter costs are compared against income and cash for the expedited SNAP destitution test.
application.expeditedSnap.monthlyUtilitiesnumberProgramssnap
ReasonMonthly utility costs combined with shelter costs are compared against income for the expedited SNAP destitution test.
application.expeditedSnap.receivedSnapInLast30DaysbooleanProgramssnap
ReasonRecent SNAP receipt in another state may indicate duplicate participation or ongoing eligibility that affects expedited processing.
application.utilitiesUtilitiesProgramssnap
application.utilities.heatCoolMethodenumgas electric oil propane otherProgramssnap
ReasonDetermines which utility allowance standard applies. Households that heat or cool with certain methods qualify for the full heating and cooling standard.
application.utilities.heatCoolMethodOtherstringProgramssnap
ReasonCaptures non-enumerated heating or cooling methods for adapter mapping to the appropriate utility standard.
application.utilities.receivesLiheapbooleanProgramssnap
ReasonReceipt of even one dollar of LIHEAP automatically qualifies the household for the full heating and cooling standard utility allowance.
application.statusenumdraft submitted under_review pending_approval withdrawn closedapplication.isExpeditedboolean | nullProgramssnap
application.submittedAtdatetimesnap medicaidapplication.withdrawnAtdatetimeapplication.closedAtdatetimeApplicationMember
application.members[]list(ApplicationMember)ReasonHousehold members on the application, including both applying and non-applying members whose data affects eligibility. Each member is linked to a contacts[] record via personId; shared identity and contact data lives there.
application.members[].personIduuid(Person)ReasonFK to application.contacts[] linking the member to their person record, which holds name, address, phone, and email shared with non-member contacts.
application.members[].iduuidReasonUnique identifier for the member record; FK target for memberId fields throughout the application model.
application.members[].applicationIduuid(Application)application.members[].roles[]enumprimary_applicant household_member non_applying_member authorized_representative absent_parentsnap medicaidReasonDetermines which application flows apply to the member and how their data is scoped within the application.
application.members[].programsAppliedFor[]enumsnap medicaid chip tanfsnap medicaid tanfReasonPer-member program application, distinct from the household-level programsAppliedFor[]. A member may apply for a subset of the programs the household is seeking.
ModelingA member's selection must be a subset of the household-level programsAppliedFor[] selection.
application.members[].purchasesAndPreparesFoodbooleanProgramssnap
ReasonMembers who purchase and prepare food separately from the rest of the household form a separate SNAP household and are excluded from the applicant's SNAP unit.
application.members[].isMigrantFarmWorkerbooleanProgramssnap
ReasonMigrant and seasonal farm workers qualify for expedited SNAP regardless of the standard income and asset thresholds.
application.members[].hasThirdPartyLiabilityClaimbooleanProgramsmedicaid
ReasonMedicaid is payer of last resort; the presence of a third-party liability claim triggers cost avoidance and recovery procedures.
application.members[].personalInformationPersonalInformationapplication.members[].personalInformation.ssnstringsnap medicaidData Classificationpii
ReasonRequired for identity verification and cross-matching against federal income and asset data sources under IEVS.
application.members[].personalInformation.dateOfBirthdatesnap medicaid chipData Classificationpii
ReasonUsed for age-based eligibility rules including CHIP age limits, SNAP elderly and disabled deductions, ABAWD rules, and foster care extended eligibility.
application.members[].personalInformation.sexAssignedAtBirthenummale female intersex unknownmedicaid chipReasonUsed for clinical eligibility determinations including pregnancy Medicaid, sex-specific health screenings, and certain household composition rules.
application.members[].personalInformation.genderIdentityenumman woman non_binary transgender_man transgender_woman prefer_not_to_answer othermedicaid chipReasonRequired to honor anti-discrimination obligations and ensure accurate, respectful correspondence with applicants.
application.members[].personalInformation.maritalStatusenumsingle married divorced separated widowed civil_union domestic_partnershipsnap medicaidReasonAffects household composition, spousal income deeming, MAGI filing status determination, and two-parent TANF household rules.
application.members[].personalInformation.races[]enumamerican_indian_alaskan_native asian black_african_american native_hawaiian_pacific_islander whitesnap medicaid tanf chipReasonRequired for civil rights reporting, equity monitoring, and program targeting.
ModelingArray to comply with OMB standards requiring that individuals be able to select all applicable races simultaneously.
application.members[].personalInformation.isHispanicOrLatinobooleansnap medicaid tanf chipReasonHispanic or Latino ethnicity is collected separately from race per OMB standards and is required for civil rights reporting.
application.members[].personalInformation.preferredSpokenLanguagestringsnap medicaidReasonDetermines which language interpreter services must be arranged for appointments and communications to ensure meaningful access.
application.members[].personalInformation.preferredWrittenLanguagestringsnap medicaidReasonDetermines which language translated notices and written communications must be provided in for meaningful access.
application.members[].contactMemberContactapplication.members[].contact.nameNameapplication.members[].contact.name.firstNamestringapplication.members[].contact.name.middleNamestringapplication.members[].contact.name.middleInitialstringapplication.members[].contact.name.lastNamestringapplication.members[].contact.name.maidenNamestringapplication.members[].contact.name.suffixstringapplication.members[].contact.primaryAddressAddressReasonUsed for residency determination, county routing for benefits administration, and physical location for home visits when required.
application.members[].contact.primaryAddress.addressLine1stringapplication.members[].contact.primaryAddress.addressLine2stringapplication.members[].contact.primaryAddress.citystringapplication.members[].contact.primaryAddress.statestringapplication.members[].contact.primaryAddress.zipstringapplication.members[].contact.primaryAddress.countystringapplication.members[].contact.primaryPhonestringReasonPrimary contact number for program notifications, interview scheduling, and verification follow-up.
application.members[].contact.emailemailReasonEmail address for electronic delivery of program notices when noticePreference includes email.
application.members[].contact.mailingAddressAddressReasonUsed for correspondence when the mailing address differs from the home address.
application.members[].contact.mailingAddress.addressLine1stringapplication.members[].contact.mailingAddress.addressLine2stringapplication.members[].contact.mailingAddress.citystringapplication.members[].contact.mailingAddress.statestringapplication.members[].contact.mailingAddress.zipstringapplication.members[].contact.mailingAddress.countystringapplication.members[].contact.alternatePhonestringReasonSecondary contact number used when the primary number is unavailable.
application.members[].contact.isExperiencingHomelessnessbooleanProgramssnap
ReasonHomelessness affects address collection requirements, shelter deduction eligibility for SNAP, and may trigger expedited processing.
application.members[].contact.noticePreferenceenumpaper email bothProgramsmedicaid
ReasonDetermines whether notices are delivered by paper mail, email, or both, per applicant preference.
application.members[].contact.alternateNoticeAddressAddressmedicaid chipReasonAlternative address for program notices, primarily used by domestic violence survivors and individuals receiving sensitive health services who need correspondence sent separately from their household address.
application.members[].contact.alternateNoticeAddress.addressLine1stringmedicaid chipapplication.members[].contact.alternateNoticeAddress.addressLine2stringmedicaid chipapplication.members[].contact.alternateNoticeAddress.citystringmedicaid chipapplication.members[].contact.alternateNoticeAddress.statestringmedicaid chipapplication.members[].contact.alternateNoticeAddress.zipstringmedicaid chipapplication.members[].contact.alternateNoticeAddress.countystringmedicaid chipapplication.members[].residencyResidencyapplication.members[].residency.isStateResidentbooleansnap medicaid tanfReasonState residency is a universal eligibility requirement across all programs; non-residents are ineligible regardless of other criteria.
application.members[].residency.stateResidencyDatedateReasonRequired for states that verify residency duration and for determining benefit start dates when a household transfers from another state.
application.members[].citizenshipCitizenshipapplication.members[].citizenship.citizenshipStatusenumus_citizen us_national non_citizensnap medicaidData Classificationpii
ReasonNon-citizens have restricted access to federal programs under PRWORA. Citizenship status determines which verification procedures and waiting periods apply.
application.members[].citizenship.certificateNumberstringProgramsmedicaid
Data Classificationpii
ReasonUS naturalization or citizenship certificate number used for SAVE verification of citizenship claims.
application.members[].citizenship.immigrantStatusenumlawful_permanent_resident refugee asylee deportation_withheld parolee conditional_entrant cuban_haitian_entrant amerasian battered_non_citizen trafficking_victim temporary_protected_status othersnap medicaidData Classificationpii
ReasonSpecific immigration category determines program eligibility, applicable waiting periods, and the required verification pathway.
application.members[].citizenship.uscisNumberOrI94stringProgramsmedicaid
Data Classificationpii
ReasonAlien registration number or I-94 admission number required to initiate FDSH VLP verification.
application.members[].citizenship.documentDocumentapplication.members[].citizenship.document.typeenumi_551 i_766 i_94 i_327 i_571 foreign_passport machine_readable_immigrant_visa otherProgramsmedicaid
Data Classificationpii
ReasonImmigration document type determines which fields FDSH VLP requires to initiate a verification check.
application.members[].citizenship.document.numberstringProgramsmedicaid
Data Classificationpii
ReasonDocument number required for FDSH VLP immigration status verification.
application.members[].citizenship.document.expirationDatedateProgramsmedicaid
Data Classificationpii
ReasonExpired immigration documents may indicate a change in immigration status that affects eligibility.
application.members[].citizenship.document.countryOfIssuancestringProgramsmedicaid
Data Classificationpii
ReasonCountry of issuance is required for foreign passport VLP verification lookups.
application.members[].citizenship.residedInUsSince1996booleansnap medicaid tanfData Classificationpii
ReasonContinuous US residence since August 22, 1996 is required for the PRWORA grandfather exemption for certain non-citizens who were receiving benefits before the law took effect.
application.members[].citizenship.hasQualifyingMilitaryConnectionbooleansnap medicaid tanfData Classificationpii
ReasonQualified non-citizens with a connection to US military service are exempt from PRWORA waiting periods.
application.members[].citizenship.sponsoredSponsoredsnap medicaid tanfData Classificationpii
application.members[].citizenship.sponsored.hasBeenAbandonedBySponsorbooleansnap medicaid tanfData Classificationpii
ReasonSponsor abandonment is a basis for exempting a sponsored non-citizen from deeming of the sponsor's income.
ModelingKept separate from hasBeenMistreatedBySponsor because abandonment (documented through lack of financial support or sponsor departure) and battery/mistreatment (VAWA-based, requiring police reports, court orders, or professional statements) have distinct legal bases and different verification pathways. Forms that combine them into a single yes/no require a state overlay.
application.members[].citizenship.sponsored.hasBeenMistreatedBySponsorbooleansnap medicaid tanfData Classificationpii
ReasonBattery or extreme cruelty by a sponsor is a basis for exempting a sponsored non-citizen from deeming under VAWA protections.
ModelingKept separate from hasBeenAbandonedBySponsor; see that field's design note for the rationale.
application.members[].citizenship.sponsored.qualifiesForSponsorDeemingExceptionbooleansnap medicaid tanfData Classificationpii
ReasonCertain sponsored non-citizens — pregnant women, children under 21 — are exempt from sponsor income deeming.
application.members[].citizenship.sponsored.receivesInKindSupportbooleansnap medicaid tanfData Classificationpii
ReasonIn-kind support and maintenance (non-cash housing and food) from a sponsor is counted as income for SSI and may affect other program determinations.
application.members[].retroactiveMedicalCoverageRetroactiveMedicalCoverageProgramsmedicaid
application.members[].retroactiveMedicalCoverage.isRequestedbooleanProgramsmedicaid
ReasonMedicaid may cover medical expenses incurred up to 3 months before the application month for eligible individuals who would have qualified during that period.
application.members[].retroactiveMedicalCoverage.periods[]list(Period)Programsmedicaid
ReasonMonthly retroactive coverage periods for which Medicaid coverage is requested, each capturing the household income for that month to determine whether the applicant would have qualified.
application.members[].retroactiveMedicalCoverage.periods[].monthstringProgramsmedicaid
ReasonIdentifies the specific months for which retroactive coverage is requested, up to the 3-month retroactive period.
application.members[].retroactiveMedicalCoverage.periods[].householdIncomenumberProgramsmedicaid
ReasonIncome during the retroactive month must be evaluated against the eligibility threshold for that month to determine whether the applicant would have qualified.
application.members[].disabilityDisabilitysnap medicaidapplication.members[].disability.isDisabledbooleansnap medicaidReasonA disabling condition lasting 12 or more months affects SNAP elderly and disabled household rules and categorical Medicaid eligibility determination.
application.members[].disability.hasLongTermConditionbooleansnap medicaidReasonIdentifies members with a condition expected to last 12 or more months, used as a screening criterion alongside isDisabled for SNAP elderly and disabled household rules and Medicaid disability determination pathways.
application.members[].disability.hasPhysicalDisabilitybooleansnap medicaidReasonIdentifies whether the member has a physical disability; collected to support SNAP elderly and disabled household deductions and Medicaid disability pathways.
application.members[].disability.hasMentalDisabilitybooleansnap medicaidReasonIdentifies whether the member has a mental disability; collected alongside hasPhysicalDisability to support SNAP and Medicaid disability determinations.
application.members[].disability.needsHelpWithSelfCarebooleansnap medicaidReasonIdentifies members who require assistance with self-care activities; used to assess functional limitations relevant to Aid and Attendance eligibility for veterans and LTSS Medicaid pathways.
application.members[].studentStatusStudentStatusProgramssnap
application.members[].studentStatus.enrollmentStatusenumfull_time part_time not_enrolledProgramssnap
ReasonFull-time students ages 18-49 are generally ineligible for SNAP unless they meet a specific exemption.
application.members[].studentStatus.institutionTypeenumhigher_education vocational otherProgramssnap
ReasonThe SNAP student eligibility restriction applies specifically to higher education; vocational training institutions may not trigger the restriction.
application.members[].studentStatus.schoolNamestringProgramssnap
ReasonSchool name used to verify enrollment status and institution type for the SNAP student restriction.
application.members[].studentStatus.isParticipatingInWorkStudybooleanProgramssnap
ReasonParticipation in a federally funded work-study program is one of the exemptions from the SNAP student eligibility restriction.
application.members[].pregnancyPregnancysnap medicaid chipapplication.members[].pregnancy.isPregnantbooleansnap medicaid chipReasonPregnancy confers categorical Medicaid eligibility and affects CHIP unborn child coverage; the expected baby counts as a household member for SNAP.
application.members[].pregnancy.dueDatedatesnap medicaid chipReasonDue date determines the benefit period for pregnancy Medicaid and the anticipated household size change for SNAP.
application.members[].pregnancy.numberOfBabiesExpectedintegersnap medicaid chipReasonEach expected baby counts as a separate household member for SNAP and Medicaid household size calculation.
application.members[].fosterCareFosterCareProgramsmedicaid
application.members[].fosterCare.startDatedateProgramsmedicaid
ReasonStart date of the most recent foster care episode; used with end date and member age to determine whether extended Medicaid eligibility applies.
application.members[].fosterCare.endDatedateProgramsmedicaid
ReasonEnd date of the most recent foster care episode; used to determine age at exit and whether the member aged out and qualifies for extended Medicaid coverage to age 26.
application.members[].fosterCare.exitReasonenumadopted reunified aged_out emancipatedProgramsmedicaid
ReasonExit reason determines eligibility pathway — aged-out youth qualify for extended Medicaid; reunification and adoption have different eligibility implications.
application.members[].fosterCare.exitStatestringProgramsmedicaid
ReasonState in which the member was in foster care; required for cross-state Medicaid eligibility for youth who aged out in another state.
application.members[].fosterCare.receivedMedicaidAtAge18booleanProgramsmedicaid
ReasonYouth who were enrolled in Medicaid at age 18 qualify for extended Medicaid coverage to age 26 regardless of current income.
application.members[].fosterCare.returnedAfterAdoptionbooleanProgramsmedicaid
ReasonYouth who re-enter foster care after an adoption dissolution may regain extended Medicaid eligibility; this flag triggers review of the re-entry date.
application.members[].fosterCare.returnDatedateProgramsmedicaid
ReasonDate of re-entry into foster care after adoption dissolution; used to determine whether extended Medicaid eligibility resumes.
application.members[].militaryMilitaryapplication.members[].military.isVeteranbooleanReasonVeteran status may affect categorical SNAP eligibility in states with broad-based categorical eligibility and may affect Medicaid when TRICARE is present.
application.members[].military.isActiveDutybooleanProgramssnap
ReasonActive duty status affects SNAP income treatment for military households and may affect TANF work activity exemptions.
application.members[].military.dischargeStatusenumhonorable general other_than_honorable bad_conduct dishonorable uncharacterizedProgramssnap
ReasonDishonorable discharge is a categorical disqualifier for SNAP; any member with a dishonorable discharge is ineligible regardless of other criteria.
application.members[].institutionalStatusInstitutionalStatussnap medicaidapplication.members[].institutionalStatus.livesInInstitutionbooleansnap medicaidReasonInstitutionalized individuals are generally ineligible for SNAP and have restricted Medicaid eligibility under IMD exclusion and LTSS rules.
application.members[].institutionalStatus.facilityNamestringsnap medicaidReasonFacility name used for verification and for determining the institution type when not explicitly collected.
application.members[].institutionalStatus.facilityTypeenumnursing_home hospital incarceration othersnap medicaidReasonFacility type determines which program restrictions apply — incarcerated individuals are ineligible for SNAP and Medicaid during incarceration.
application.members[].institutionalStatus.dateEntereddatesnap medicaidReasonEntry date used to determine the period of ineligibility and whether a partial-month benefit applies.
application.members[].institutionalStatus.pendingDispositionOfChargesbooleansnap medicaidReasonIndividuals detained pending disposition of charges retain Medicaid eligibility; convicted and incarcerated individuals do not.
application.members[].institutionalStatus.mealsProvidedbooleansnap medicaidReasonInstitutions that provide meals may constitute a separate food purchasing unit, affecting SNAP household composition.
application.members[].priorConvictionsPriorConvictionsapplication.members[].priorConvictions.isFleeingFelonbooleansnap tanfReasonIndividuals fleeing to avoid prosecution or confinement for a felony are ineligible for SNAP and TANF.
application.members[].priorConvictions.convictedOfDrugRelatedFelonybooleansnap tanfReasonDrug-related felony convictions may disqualify a member from SNAP and TANF depending on state implementation of the federal option.
application.members[].priorConvictions.convictedDuplicateSnapBenefitsbooleansnap tanfReasonConviction for receiving duplicate SNAP benefits results in a disqualification period proportional to the offense.
application.members[].priorConvictions.convictedOfSnapTraffickingbooleansnap tanfReasonConviction for trafficking SNAP benefits over $500 results in permanent disqualification.
application.members[].priorConvictions.convictedTradingSnapForFirearmsOrExplosivesbooleansnap tanfReasonConviction for trading SNAP benefits for firearms, ammunition, or explosives results in permanent disqualification.
application.members[].priorConvictions.convictedOfDisqualifyingViolentCrimebooleansnap tanfReasonConviction for murder or certain sexual offenses results in permanent SNAP disqualification under the Agriculture Improvement Act.
application.members[].priorConvictions.disqualifiedForIPVbooleansnap tanfReasonA prior intentional program violation (IPV) disqualification carries over and may trigger an extended or permanent disqualification period.
application.members[].priorConvictions.isViolatingProbationOrParolebooleansnap tanfReasonIndividuals violating probation or parole conditions are ineligible for SNAP and TANF.
application.members[].tribalStatusTribalStatusmedicaid chipapplication.members[].tribalStatus.isAmericanIndianOrAlaskaNativebooleanmedicaid chipReasonAmerican Indian and Alaska Native members have special Medicaid and CHIP eligibility protections and are eligible for Indian Health Service coordination.
application.members[].tribalStatus.tribeNamestringmedicaid chipReasonTribe name used to verify tribal membership and coordinate with IHS and tribal health programs.
application.members[].tribalStatus.tribeStatestringmedicaid chipReasonState where the tribe is located, used to identify the relevant IHS service area and tribal health program.
application.members[].personMatchstringReasonPerson matching state for an application member. Populated when the client management domain resolves a match; null until matching begins.
application.members[].programDeterminations[]list(ApplicationMemberProgramDetermination)ReasonPer-program eligibility determination results for this member, populated by the rules engine at determination. One record per program evaluated.
application.members[].programDeterminations[].programstringReasonProgram identifier the determination applies to (e.g., snap, medicaid, tanf).
application.members[].programDeterminations[].outcomeenumapproved deniedReasonDetermination outcome — approved or denied — for this member/program combination.
application.members[].programDeterminations[].determinedAtdatetimeReasonWhen the determination was recorded by the rules engine.
ApplicationHousehold
application.householdInfo.iduuidapplication.householdInfo.applicationIduuid(Application)application.householdInfo.roomers[]list(Roomer)Programssnap
ReasonIdentifies roomers and boarders in the home who are not SNAP household members because they purchase and prepare food separately.
application.householdInfo.roomers[].iduuidProgramssnap
ReasonIdentifier of the referenced person record; points to application.members[].id when type = member, or application.contacts[].id when type = contact.
application.householdInfo.roomers[].typeenummember contactProgramssnap
ReasonDiscriminator identifying whether the roomer is a household member or a contact-only person record in application.contacts[].
application.householdInfo.roomers[].amountPaidForRentnumberProgramssnap
ReasonRent paid by a roomer is income to the household; distinguishes market-rate roomers from boarders.
application.householdInfo.roomers[].mealsIncludedWithRentbooleanProgramssnap
ReasonWhen meals are included, the person is a boarder; meal revenue is income. When meals are not included, rent revenue is income.
ModelingBoarders are not modeled as a separate type — they are roomers where mealsIncludedWithRent = true. A single roomers[] array with this boolean covers both cases without a discriminated union.
application.householdInfo.utilitiesIncludedInRentbooleanProgramssnap
ReasonWhen utilities are included in rent, the household may not claim a utility standard deduction for SNAP.
application.householdInfo.isSubsidizedHousingbooleanProgramssnap
ReasonResidents of federally subsidized housing are ineligible for the heating and cooling standard utility allowance.
application.householdInfo.receivedTanfInAnotherStatebooleanProgramstanf
ReasonCross-state TANF receipt is verified to prevent duplicate participation and enforce time limits across states.
TaxFiler
application.taxFilers[]list(TaxFiler)medicaid chipReasonTax filing units within the household, used to determine MAGI tax household composition for Medicaid and marketplace eligibility. Each record represents one tax filer and their dependents.
application.taxFilers[].iduuidmedicaid chipapplication.taxFilers[].memberIduuid(ApplicationMember)medicaid chipReasonLinks the tax filer record to the household member. Null when the filer is a non-household member claiming a household dependent.
ModelingA null memberId encodes a non-household filer (e.g. a non-custodial parent not on this application). This is the mechanism for representing filers whose name and identity are not already in application.members[].
application.taxFilers[].applicationIduuid(Application)medicaid chipapplication.taxFilers[].filingJointlyWithSpousebooleanmedicaid chipReasonJoint filing status affects MAGI household composition and income attribution for Medicaid and marketplace eligibility.
application.taxFilers[].spousePersonRefmedicaid chipapplication.taxFilers[].spouse.iduuidmedicaid chipReasonIdentifier of the referenced person record for the spouse; used to link a non-household spouse to their contacts[] entry.
application.taxFilers[].spouse.typeenummember contactmedicaid chipReasonDiscriminator identifying whether the filing spouse is a household member or a contact-only person record in application.contacts[].
application.taxFilers[].claimingDependentsbooleanmedicaid chipReasonClaiming dependents affects MAGI household size and the income of dependents attributed to the tax household.
application.taxFilers[].dependents[]list(PersonRef)medicaid chipapplication.taxFilers[].dependents[].iduuidmedicaid chipReasonIdentifier of the referenced person record for the dependent; points to application.members[].id when type = member, or application.contacts[].id when type = contact.
application.taxFilers[].dependents[].typeenummember contactmedicaid chipReasonDistinguishes household members (who have a member record) from non-household dependents (who are contact-only person records in application.contacts[]).
ModelingPolymorphic discriminator enabling FK linkage for both household members (via application.members[].id) and non-household dependents (via application.contacts[].id).
application.taxFilers[].expectedToBeClaimedByNonHouseholdMemberbooleanmedicaid chipReasonA household member expected to be claimed as a dependent by someone outside the household uses that person's tax household for MAGI purposes.
application.taxFilers[].personClaimingPersonRefmedicaid chipapplication.taxFilers[].personClaiming.iduuidmedicaid chipReasonIdentifier of the person claiming this applicant as a dependent; used to determine the applicable tax household for MAGI purposes.
application.taxFilers[].personClaiming.typeenummember contactmedicaid chipReasonDiscriminator identifying whether the person claiming this applicant as a dependent is a household member or a contact-only person record in application.contacts[].
application.taxFilers[].isNonCustodialParentbooleanmedicaid chipReasonNon-custodial parents who claim a child as a dependent use a different MAGI household composition rule.
application.taxFilers[].hasDomesticViolenceTaxFilingExceptionbooleanmedicaid chipReasonDomestic violence survivors may file separately from their spouse even if married, preventing their spouse's income from being included in the MAGI household.
HealthPlan
application.healthPlans[]list(HealthPlan)medicaid chip acaReasonHealth insurance plans reported by the household, covering all coverage types — employer-sponsored, COBRA, Medicare, TRICARE, VA, marketplace, and others. Each plan record is shared across members via healthEnrollments[].
ModelingMedicare plans use a single healthPlan record per person (type = medicare) with named sub-objects for each part (partA, partB, partC, partD). Parts A–D are a fixed closed set, so named sub-objects are cleaner than a discriminated array.
application.healthPlans[].organizationIduuid(Organization)type in [employer_sponsored, cobra]medicaid chip acaReasonFK to application.organizations[] for employer-sponsored and COBRA plans, linking the plan to the employer organization record without duplicating employer contact data.
ModelingApplies only when type = employer_sponsored or cobra.
application.healthPlans[].iduuidmedicaid chip acaReasonUnique identifier for the health plan record; FK target for application.healthEnrollments[].healthPlanId.
application.healthPlans[].applicationIduuid(Application)medicaid chip acaapplication.healthPlans[].typeenumemployer_sponsored cobra medicare tricare va marketplace peace_corps chip medicaid tribal_health_services other_federal othermedicaid chip acaReasonCoverage type determines minimum essential coverage (MEC) status, marketplace eligibility, and Medicare Savings Program (MSP) screening.
application.healthPlans[].typeOtherstringmedicaid chip acaReasonCaptures non-enumerated coverage types for adapter review and manual classification.
application.healthPlans[].coverageContactNametype in [employer_sponsored, cobra]medicaid chip acaReasonHR or benefits contact at the employer for plan verification and enrollment period confirmation.
application.healthPlans[].coverageContact.firstNamestringtype in [employer_sponsored, cobra]medicaid chip acaapplication.healthPlans[].coverageContact.middleNamestringtype in [employer_sponsored, cobra]medicaid chip acaapplication.healthPlans[].coverageContact.middleInitialstringtype in [employer_sponsored, cobra]medicaid chip acaapplication.healthPlans[].coverageContact.lastNamestringtype in [employer_sponsored, cobra]medicaid chip acaapplication.healthPlans[].coverageContact.maidenNamestringtype in [employer_sponsored, cobra]medicaid chip acaapplication.healthPlans[].coverageContact.suffixstringtype in [employer_sponsored, cobra]medicaid chip acaapplication.healthPlans[].hasMinimumValuePlanbooleantype in [employer_sponsored, cobra]Programsaca
ReasonAn employer plan that meets minimum value (covers at least 60% of costs) blocks marketplace premium tax credit eligibility.
application.healthPlans[].lowestCostPlanNamestringtype in [employer_sponsored, cobra]medicaid chip acaReasonIdentifies the lowest-cost minimum value plan offered by the employer, used in the affordability test.
application.healthPlans[].lowestCostPlanPremiumnumbertype in [employer_sponsored, cobra]Programsaca
ReasonThe self-only premium of the lowest-cost minimum value plan is the benchmark for the ACA affordability test.
application.healthPlans[].medicareIdstringtype = medicaremedicaid chip acaReasonMedicare Beneficiary Identifier (MBI) is required for all Medicare processing. One MBI covers all parts for a beneficiary.
ModelingTreat as PII. The MBI replaced the SSN-based Health Insurance Claim Number (HICN) in 2018–2020.
application.healthPlans[].partAMedicareParttype = medicareProgramsmedicaid
application.healthPlans[].partA.statusenumtype = medicareentitled enrolledProgramsmedicaid
ReasonEntitled vs. enrolled distinction affects Medicare Savings Program eligibility; entitled-but-not-enrolled may qualify for MSP to cover Part A premiums. Parts C and D have no entitled-without-enrolled state — status will always be enrolled for those parts.
Modelingentitled = meets eligibility criteria but not yet actively receiving benefits (e.g., deferred Part B enrollment while on employer coverage); enrolled = actively receiving.
application.healthPlans[].partA.startDatedatetype = medicareProgramsmedicaid
ReasonPart A effective date used for coordination with Medicaid and the Medicare Savings Program.
application.healthPlans[].partA.isPremiumFreebooleantype = medicareProgramsmedicaid
ReasonBeneficiaries who did not earn 40 quarters of work pay a Part A premium; premium amount affects MSP and QMB eligibility.
application.healthPlans[].partBMedicareParttype = medicaremedicaid chip acaapplication.healthPlans[].partB.statusenumtype = medicareentitled enrolledmedicaid chip acaReasonPart B enrollment status affects MSP eligibility and late enrollment penalty determination.
application.healthPlans[].partB.startDatedatetype = medicaremedicaid chip acaReasonPart B effective date used for late enrollment penalty calculation and MSP coordination.
application.healthPlans[].partB.isPremiumFreebooleantype = medicaremedicaid chip acaReasonIdentifies whether the beneficiary qualifies for a premium-free Part B; affects Medicare Savings Program cost calculation.
application.healthPlans[].partCMedicarePartCtype = medicaremedicaid chip acaapplication.healthPlans[].partC.statusenumtype = medicareentitled enrolledmedicaid chip acaReasonPart C (Medicare Advantage) enrollment status; a Part C enrollee receives Parts A and B benefits through the plan.
ModelingPart C replaces traditional Parts A and B — a member enrolled in Part C should not also have Part A and Part B populated.
application.healthPlans[].partC.startDatedatetype = medicaremedicaid chip acaReasonPart C effective date for coordination with Medicaid dual-eligible programs.
application.healthPlans[].partC.contractIdstringtype = medicaremedicaid chip acaReasonCMS contract ID uniquely identifies the Medicare Advantage organization. Required for plan identification in CMS enrollment data.
application.healthPlans[].partC.planIdstringtype = medicaremedicaid chip acaReasonCMS plan ID combined with contract ID uniquely identifies the specific Medicare Advantage plan.
application.healthPlans[].partC.planNamestringtype = medicaremedicaid chip acaReasonHuman-readable Medicare Advantage plan name for applicant correspondence and worker review.
application.healthPlans[].partDMedicarePartDtype = medicaremedicaid chip acaapplication.healthPlans[].partD.statusenumtype = medicareentitled enrolledmedicaid chip acaReasonPart D prescription drug coverage status for coordination of benefits.
application.healthPlans[].partD.startDatedatetype = medicaremedicaid chip acaReasonPart D effective date for coordination with Medicaid drug coverage.
application.healthPlans[].partD.planNamestringtype = medicaremedicaid chip acaReasonPrescription drug plan name for coordination of benefits identification.
application.healthPlans[].programTypestringtype = tricaremedicaid chip acaReasonIdentifies the specific federal health program (TRICARE, VA, Peace Corps, etc.) for verification and MEC determination.
application.healthPlans[].insuranceCompanyNamestringtype = tricaremedicaid chip acaReasonInsurance carrier for TRICARE supplemental or managed care plans, required for coordination of benefits.
application.healthPlans[].policyNumberstringtype = tricaremedicaid chip acaReasonPolicy number required for benefits verification and coordination of benefits.
HealthEnrollment
application.healthEnrollments[]list(HealthEnrollment)ReasonJoin records linking household members to health plans, capturing each member's role and enrollment status. A plan record in healthPlans[] may have multiple enrollment records — one per covered member.
application.healthEnrollments[].healthPlanIduuid(HealthPlan)ReasonFK to application.healthPlans[] identifying the plan this member is enrolled in.
application.healthEnrollments[].jobIduuid(Job)ReasonFK to application.jobs[] linking an employer-sponsored enrollment to the specific job, enabling employer contact lookup without duplicating employer data.
application.healthEnrollments[].iduuidReasonUnique identifier for the enrollment record.
application.healthEnrollments[].memberIduuid(ApplicationMember)ReasonFK to members[] identifying the household member enrolled in this plan.
application.healthEnrollments[].applicationIduuid(Application)application.healthEnrollments[].roleenumsubscriber dependentReasonSubscriber vs. dependent role affects premium attribution for the ACA employer coverage affordability test.
application.healthEnrollments[].startDatedateReasonCoverage start date; used to determine coverage gap periods relevant to MEC analysis and special enrollment eligibility.
application.healthEnrollments[].endDatedateProgramsaca
ReasonDate coverage lapsed, triggering special enrollment period eligibility for marketplace.
application.healthEnrollments[].eligibleDatedateReasonDate the member becomes eligible for coverage; used to determine whether a special enrollment period applies.
application.healthEnrollments[].enrollmentStatusenumeligible enrolled pending endedmedicaid acaReasonDistinguishes members who are eligible (offered coverage) from those who are enrolled (actively covered) and those whose coverage has ended; each status has different implications for marketplace eligibility and MSP screening.
application.healthEnrollments[].prefersSeparateMailingbooleanmedicaid chip acaReasonMembers have the right to request that health coverage notices be sent to an alternative address, primarily for domestic violence safety and health information privacy.
application.healthEnrollments[].sponsorPersonRefapplication.healthEnrollments[].sponsor.iduuidapplication.healthEnrollments[].sponsor.typeenummember contactApplicationChildSupport
application.childSupport.iduuidapplication.childSupport.applicationIduuid(Application)application.childSupport.goodCauseChildSupportWaiverbooleansnap medicaid tanfReasonApplicants who cooperate with child support enforcement may claim a good cause exception if cooperation would put them or their children at risk of harm.
application.childSupport.parentsOutsideHome[]list(ParentOutsideHome)snap tanfReasonNon-custodial parents outside the home identified for child support enforcement referral, which is a condition of TANF receipt.
application.childSupport.parentsOutsideHome[].iduuidsnap tanfReasonIdentifier of the referenced person record for the non-custodial parent; the person record holds their name, address, and phone for enforcement contact.
application.childSupport.parentsOutsideHome[].typeenummember contactsnap tanfReasonDiscriminator identifying whether the non-custodial parent is a household member or a contact-only person record in application.contacts[].
application.childSupport.parentsOutsideHome[].children[]list(PersonRef)snap tanfReasonIdentifies which children in the household are associated with this non-custodial parent for child support enforcement purposes.
ModelingArray because one non-custodial parent may be the parent of multiple children in the household.
application.childSupport.parentsOutsideHome[].children[].iduuidsnap tanfReasonIdentifier of the referenced child person record.
application.childSupport.parentsOutsideHome[].children[].typeenummember contactsnap tanfReasonDiscriminator identifying whether the child is a household member or a contact-only person record.
application.childSupport.parentsOutsideHome[].attemptedMedicalSupportCooperationbooleanProgramsmedicaid
ReasonMedicaid applicants are required to cooperate with medical support enforcement as a condition of eligibility.
Contact
application.contacts[]list(Contact)ReasonRegistry of all individuals referenced in the application — household members and non-members alike (authorized representatives, helpers, sponsors, tax dependents, non-custodial parents, etc.). Members link to their contacts[] record via application.members[].personId. Non-member individuals are "contacts" with a contacts[] record but no application.members[] entry.
application.contacts[].iduuidReasonUnique identifier for the person record; referenced throughout the model via member|contact discriminator pairs (type + id).
application.contacts[].applicationIduuid(Application)application.contacts[].nameNameReasonLegal name of the person for identity verification, correspondence, and data matching across programs.
application.contacts[].name.firstNamestringapplication.contacts[].name.middleNamestringapplication.contacts[].name.middleInitialstringapplication.contacts[].name.lastNamestringapplication.contacts[].name.maidenNamestringapplication.contacts[].name.suffixstringapplication.contacts[].primaryAddressAddressReasonMailing address for correspondence directed to this person, used when the person is a non-member contact such as an authorized representative or sponsor.
application.contacts[].primaryAddress.addressLine1stringapplication.contacts[].primaryAddress.addressLine2stringapplication.contacts[].primaryAddress.citystringapplication.contacts[].primaryAddress.statestringapplication.contacts[].primaryAddress.zipstringapplication.contacts[].primaryAddress.countystringapplication.contacts[].primaryPhonestringReasonContact phone number for this person, used for non-member contacts such as authorized representatives and helpers.
application.contacts[].emailemailReasonEmail address for electronic correspondence, used for non-member contacts who opt in to electronic notices.
Organization
application.organizations[]list(Organization)ReasonRegistry of legal entities referenced in the application — employers, organizational authorized representatives, and other entities. Members reference organizations via healthPlans[].organizationId, jobs[].employerId, and authorized representative records.
application.organizations[].iduuidReasonUnique identifier for the organization record; referenced by FK fields throughout the model.
application.organizations[].applicationIduuid(Application)application.organizations[].namestringReasonLegal name of the organization for correspondence, verification, and reporting.
application.organizations[].einstringReasonEmployer Identification Number used for income verification and employer contact.
application.organizations[].addressAddressReasonOrganization's address for verification and contact when phone is unavailable.
application.organizations[].address.addressLine1stringapplication.organizations[].address.addressLine2stringapplication.organizations[].address.citystringapplication.organizations[].address.statestringapplication.organizations[].address.zipstringapplication.organizations[].address.countystringapplication.organizations[].phonestringReasonOrganization's phone number for income verification and plan enrollment contact.
PersonRelationship
application.personRelationships[]list(PersonRelationship)snap medicaidReasonDirected relationship records between people in the application, used for caretaker relative eligibility, spousal income deeming, dependent care attribution, and co-applicant signature traversal. Both directions are always stored.
ModelingConvention — from IS THE [relationshipType] OF to. Storing both directions (A→B parent, B→A child) means callers can query from = X to get all of X's relationships with the correct type label without requiring bidirectional joins.
application.personRelationships[].iduuidsnap medicaidapplication.personRelationships[].applicationIduuid(Application)snap medicaidapplication.personRelationships[].fromPersonRefsnap medicaidReasonSource person in a directed relationship; from IS THE [relationshipType] OF to.
application.personRelationships[].from.iduuidsnap medicaidReasonIdentifier of the source person record; points to application.members[].id when type = member, or application.contacts[].id when type = contact.
application.personRelationships[].from.typeenummember contactsnap medicaidReasonDiscriminator identifying whether the source person is a household member or a contact-only person record.
application.personRelationships[].toPersonRefsnap medicaidReasonTarget person in a directed relationship.
application.personRelationships[].to.iduuidsnap medicaidReasonIdentifier of the target person record; points to application.members[].id when type = member, or application.contacts[].id when type = contact.
application.personRelationships[].to.typeenummember contactsnap medicaidReasonDiscriminator identifying whether the target person is a household member or a contact-only person record.
application.personRelationships[].relationshipTypes[]enumparent child spouse domestic_partner sibling grandparent grandchild legal_guardian caregiver primary_caregiver other_relative unrelatedsnap medicaidReasonRelationship type(s) from the source person's perspective. An array to support compound relationships (e.g., both sibling and caregiver). Both directions are always stored so queries on either party return the correct type label.
AuthorizedRepresentative
application.authorizedRepresentatives[]list(AuthorizedRepresentative)snap medicaidReasonIndividuals or organizations designated by household members to act on their behalf for specific benefit programs. Authority may be scoped to a subset of programs and may differ by member.
application.authorizedRepresentatives[].iduuidsnap medicaidReasonIdentifier of the referenced person or organization record; points to application.members[].id, application.contacts[].id, or application.organizations[].id depending on type.
application.authorizedRepresentatives[].appointedByMemberIduuid(ApplicationMember)snap medicaidReasonFK to application.members[] identifying which household member appointed this representative; required when members on the same application may designate different representatives for different programs.
application.authorizedRepresentatives[].applicationIduuid(Application)snap medicaidapplication.authorizedRepresentatives[].typeenummember contact organizationsnap medicaidReasonDetermines whether the representative is a natural person or an organization, which affects which record the id field points to and how authority is verified.
ModelingPolymorphic discriminator; id points to application.contacts[].id when type = individual and application.organizations[].id when type = organization.
application.authorizedRepresentatives[].inCareOfPersonRefsnap medicaidapplication.authorizedRepresentatives[].inCareOf.iduuidsnap medicaidReasonIdentifier of the person within the organization to whom correspondence should be directed.
application.authorizedRepresentatives[].inCareOf.typeenummember contactsnap medicaidReasonDiscriminator identifying whether the in-care-of contact is a household member or a contact-only person record in application.contacts[]; used when mail to an organizational representative should be directed to a specific individual.
application.authorizedRepresentatives[].receivesNoticesbooleansnap medicaidReasonDetermines whether program notices are sent to the representative instead of, or in addition to, the applicant.
application.authorizedRepresentatives[].programs[]enumsnap medicaid chip tanf acasnap medicaidReasonScopes the representative's authority to specific programs. A representative may be authorized for some programs but not others on a multi-program application.
Signature
application.signatures[]list(Signature)snap medicaidReasonSignature events on the application, each capturing who signed, in what capacity, for what legal purpose, and by what method. A single application may have multiple distinct signature events.
application.signatures[].iduuidsnap medicaidapplication.signatures[].applicationIduuid(Application)snap medicaidapplication.signatures[].signerSignersnap medicaidapplication.signatures[].signer.iduuidsnap medicaidReasonIdentifier of the referenced person or organization record who is the signer.
application.signatures[].signer.typeenummember contact organizationsnap medicaidReasonDiscriminator identifying whether the signer is a household member, a contact-only person, or an organization.
application.signatures[].signer.roleenumapplicant authorized_representative helpersnap medicaidReasonIdentifies the capacity in which the signer is signing — as the applicant member, their authorized representative, or a third-party helper who assisted with the form.
application.signatures[].purposeenumapplication authorized_representative_appointment authorized_representative_acceptance rights_and_responsibilities hipaa_consent othersnap medicaidReasonA single application may require multiple legally distinct signature events with different legal bases, signers, and timing.
ModelingDiscriminator enabling each signature event to be stored and audited independently on the same application record.
application.signatures[].signedAtdatetimesnap medicaidReasonDate and time of signature required for audit trail, benefit period determination, and legal validity.
application.signatures[].signatureMethodenumelectronic wet_signature verbalsnap medicaidReasonDistinguishes electronic, wet ink, and verbal signatures; states must track method for legal validity and audit purposes.
Sponsor
application.sponsors[]list(Sponsor)snap medicaid tanfReasonImmigration sponsors whose income is deemed to sponsored non-citizen household members under PRWORA. Each record links a sponsor to the specific member whose benefits are subject to deeming.
application.sponsors[].sponsoredMemberIduuid(ApplicationMember)snap medicaid tanfReasonFK to application.members[] identifying the household member whose benefits may be subject to sponsor income deeming.
application.sponsors[].iduuidsnap medicaid tanfReasonUnique identifier for the sponsor record.
application.sponsors[].applicationIduuid(Application)snap medicaid tanfapplication.sponsors[].typeenummember contactsnap medicaid tanfReasonDiscriminator identifying whether the sponsor is a household member or a contact-only person record in application.contacts[].
application.sponsors[].ssnstringsnap medicaid tanfData Classificationpii
ReasonSponsor's SSN required for income and asset verification through IEVS and FDSH.
application.sponsors[].spouseSpousesnap medicaid tanfapplication.sponsors[].spouse.iduuidsnap medicaid tanfReasonIdentifier of the referenced person record for the sponsor's spouse.
application.sponsors[].spouse.typeenummember contactsnap medicaid tanfReasonDiscriminator identifying whether the sponsor's spouse is a household member or a contact-only person record in application.contacts[].
application.sponsors[].spouse.ssnstringsnap medicaid tanfReasonSponsor spouse's SSN required for verification of the spouse's income, which may also be deemed to the sponsored non-citizen.
application.sponsors[].spouse.signedAffidavitbooleansnap medicaid tanfReasonIndicates whether the sponsor's spouse co-signed the I-864 affidavit of support, which affects the scope of income deeming.
application.sponsors[].householdSizeintegersnap medicaid tanfReasonSponsor household size is used in the deeming formula to calculate the sponsor's available income attributable to the sponsored non-citizen.
application.sponsors[].incomenumbersnap medicaid tanfReasonSponsor's gross income is the starting point for the deeming calculation; a portion is attributed to the sponsored non-citizen as deemed income.
application.sponsors[].livesWithSponsoredbooleansnap medicaid tanfReasonWhen the sponsor lives with the sponsored non-citizen, a different deeming formula applies.
Job
application.jobs[]list(Job)snap medicaidpii ftiReasonEmployment records for household members, covering both employed and self-employed income sources. Each record represents one job and links to income records via jobId.
application.jobs[].employerIduuid(Organization)type = employedsnap medicaidpii ftiReasonFK to application.organizations[] linking the job to the employer organization record; avoids duplicating employer name, address, and EIN across multiple jobs at the same employer.
application.jobs[].iduuidsnap medicaidpii ftiReasonUnique identifier for the job record; FK target for application.incomes[].jobId and application.healthEnrollments[].jobId.
application.jobs[].memberIduuid(ApplicationMember)snap medicaidpii ftiReasonFK to members[] linking this job to the household member who holds it.
application.jobs[].applicationIduuid(Application)application.jobs[].typeenumemployed self_employedsnap medicaidpii ftiReasonEmployed vs. self-employed status determines the income calculation method, allowable expense deductions, and applicable verification documents.
application.jobs[].statusenumactive on_strike endedProgramssnap
pii ftiReasonCurrent employment status; on_strike triggers SNAP household strike disqualification rules for the striking member.
application.jobs[].hoursPerWeeknumbersnap tanfpii ftiReasonAverage weekly hours used for TANF work participation rate calculation and SNAP ABAWD employment exemption determination.
application.jobs[].isTemporarybooleansnap medicaidpii ftiReasonTemporary employment affects SNAP income averaging rules and TANF work activity categorization.
application.jobs[].startDatedatesnap medicaidpii ftiReasonEmployment start date used to verify duration and determine which income is countable in the current benefit period.
application.jobs[].endDatedatesnap medicaidpii ftiReasonEmployment end date used to identify recent job loss for expedited processing screening and income change evaluation.
application.jobs[].endReasonenumvoluntary_separation involuntary_separationsnap tanfpii ftiReasonVoluntary separation without good cause may result in TANF disqualification; participation in a labor strike disqualifies the striking member from SNAP.
application.jobs[].strikeStartDatedatesnap medicaidpii ftiReasonDate the labor strike began; used to determine whether the SNAP strike disqualification period applies and to establish the duration of the disqualification.
application.jobs[].lastPaycheckDatedatesnap medicaidpii ftiReasonDate of last paycheck required to determine the income counting period when employment recently ended.
application.jobs[].lastPaycheckGrossAmountnumbersnap medicaidpii ftiReasonGross amount of last paycheck used for income verification when pay stubs from the current period are unavailable.
application.jobs[].businessNamestringtype = self_employedsnap medicaidpii ftiReasonTrade name or DBA name of the self-employment business for verification and worker review.
application.jobs[].businessTypestringtype = self_employedsnap medicaidpii ftiReasonType of self-employment business may affect which expense categories are allowable deductions.
application.jobs[].reportingMonthdatetype = self_employedsnap medicaidpii ftiReasonThe month for which self-employment income is being reported; used when income varies month to month and a single reporting period must be designated for calculation.
application.jobs[].expensesSelfEmploymentExpensestype = self_employedapplication.jobs[].expenses.utilitiesnumbertype = self_employedProgramssnap
pii ftiReasonUtility costs paid for business use are an allowable deduction from self-employment gross income.
application.jobs[].expenses.taxesnumbertype = self_employedProgramssnap
pii ftiReasonBusiness taxes paid are an allowable deduction from self-employment gross income.
application.jobs[].expenses.interestnumbertype = self_employedProgramssnap
pii ftiReasonBusiness interest payments are an allowable deduction from self-employment gross income.
application.jobs[].expenses.laborCostsnumbertype = self_employedProgramssnap
pii ftiReasonGross labor costs paid to employees are an allowable deduction from self-employment gross income.
application.jobs[].expenses.costOfMerchandisenumbertype = self_employedProgramssnap
pii ftiReasonCost of goods or merchandise sold is an allowable deduction from self-employment gross income.
application.jobs[].expenses.othernumbertype = self_employedProgramssnap
pii ftiReasonOther allowable business expenses not captured in the enumerated categories, subject to worker review.
Income
application.incomes[]list(Income)snap medicaidpii ftiReasonIncome records for household members across all income types — employed, self-employed, unearned, lump sum, and in-kind. Each record represents one income source for one member. The prior_period type captures income from earlier in the current tax year not reflected in current reported income (e.g. a job that ended mid-year).
ModelingFor prior_period records, only amount is relevant; frequency is inapplicable and jobId should be populated where the source is known.
application.incomes[].jobIduuid(Job)type in [employed, self_employed]snap medicaidpii ftiReasonFK to application.jobs[] linking employed income to the specific job that generated it. Enables per-job income calculation when a member holds multiple jobs.
Modelinguuid type because it is a foreign key reference, not a free-text identifier.
application.incomes[].iduuidsnap medicaidpii ftiReasonUnique identifier for the income record.
application.incomes[].memberIduuid(ApplicationMember)snap medicaidpii ftiReasonFK to application.members[] linking this income record to the household member who receives it.
application.incomes[].applicationIduuid(Application)application.incomes[].typeenumemployed self_employed unearned lump_sum in_kind_support tribal education_grant other prior_periodsnap medicaidpii ftiReasonIncome type determines the calculation method, applicable exclusions, verification requirements, and program-specific treatment.
application.incomes[].typeOtherstringsnap medicaidpii ftiReasonCaptures non-enumerated income types for adapter mapping and worker review.
application.incomes[].amountnumbersnap medicaidpii ftiReasonThe income amount for the given frequency period, used as the basis for all income calculations.
ModelingStored as reported (per-period amount) rather than normalized to monthly, to preserve the precision of the applicant's reported figure and allow adapters to apply program-specific normalization methods.
application.incomes[].frequencyenumdaily weekly every_two_weeks twice_monthly monthly yearly variablesnap medicaidpii ftiReasonFrequency is required to normalize income to a monthly or annual figure for eligibility calculation and comparison against program thresholds. When frequency = variable, programs using projected annual income (MAGI Medicaid, marketplace) use the amount directly; programs using current periodic income (SNAP, TANF) should treat it as an estimate requiring worker review.
Modelingfrequency = variable means amount is the projected annual income, not a per-period figure. Applies to employed and self_employed types only.
application.incomes[].dateReceiveddatesnap medicaidpii ftiReasonDate of receipt required for lump sum income to determine which benefit month is affected by the payment.
application.incomes[].changeReasonenumstopped_working hours_reduced new_job change_in_employment marital_status_change othersnap medicaidpii ftiReasonCategorical reason for a recent income change, used for case worker review and to validate projected annual income under MAGI rules.
application.incomes[].changeExplanationstringmedicaid chippii ftiReasonFree-text narrative explaining an income change; required by MAGI rules when projected income differs materially from annualized pay stubs.
application.incomes[].unearnedTypeenumtype = unearnedunemployment kinship_payment veterans_programs adoption_and_refugee_services ssi_or_ssdi private_disability workers_compensation disability_from_veterans_programs legal_settlement scholarship educational_grant work_study spousal_support child_support retirement_or_pension investment_interest_and_dividends social_security_retirement rental_income gambling_or_lottery_winnings gifts_or_donations loan_or_mortgage_income research_participation otherProgramssnap
pii ftiReasonSpecific unearned income type determines exclusion rules, verification source, and program-specific counting treatment.
application.incomes[].inKindSupportTypeenumtype = in_kind_supportshelter food utilities otherProgramsmedicaid
pii ftiReasonType of in-kind support received — shelter, food, utilities, or other — determines the applicable income counting rule and SSI valuation method.
application.incomes[].payerNamestringtype = in_kind_supportsnap medicaidpii ftiReasonName of the person or organization providing in-kind support, for verification and determination of whether support is from a sponsor subject to deeming rules.
application.incomes[].lumpSumTypeenumtype = lump_sumlawsuit_settlement insurance_settlement social_security_ssi_ssdi_payment veterans inheritance surrender_of_annuity life_insurance_payout lottery_gambling_winnings othersnap medicaidpii ftiReasonLump sum type determines how the payment is treated across programs — some types are excluded, others are counted in the month of receipt or prorated.
Asset
application.assets[]list(Asset)snap medicaidData Classificationpii
ReasonAsset records for household members — liquid assets, vehicles, real property, retirement accounts, and insurance — used in the SNAP asset test and Medicaid resource determination.
application.assets[].iduuidsnap medicaidData Classificationpii
ReasonUnique identifier for the asset record.
application.assets[].memberIduuid(ApplicationMember)snap medicaidData Classificationpii
ReasonFK to application.members[] linking this asset to the household member who owns it.
application.assets[].applicationIduuid(Application)application.assets[].typeenumliquid vehicle real_property retirement_account insurance othersnap medicaidData Classificationpii
ReasonAsset type determines which countability rules apply and what verification is required.
application.assets[].typeOtherstringsnap medicaidData Classificationpii
ReasonCaptures non-enumerated asset types for worker review and manual classification.
application.assets[].valuenumbersnap medicaidData Classificationpii
ReasonCurrent market value of the asset, used in the SNAP asset test and Medicaid resource determination.
application.assets[].financialInstitutionNamestringtype in [liquid, retirement_account]snap medicaidData Classificationpii
ReasonFinancial institution name for liquid asset verification through bank statements or electronic verification.
application.assets[].accountNumberstringtype in [liquid, retirement_account]snap medicaidData Classificationpii
ReasonAccount number for liquid asset verification and cross-matching.
application.assets[].yearstringtype = vehiclesnap medicaidData Classificationpii
ReasonVehicle year is used with make and model to determine fair market value for the SNAP vehicle asset test.
application.assets[].makestringtype = vehiclesnap medicaidData Classificationpii
ReasonVehicle make used with year and model for fair market value determination.
application.assets[].modelstringtype = vehiclesnap medicaidData Classificationpii
ReasonVehicle model used with year and make for fair market value determination.
application.assets[].policyTypeenumtype = insuranceterm permanent burial othersnap medicaidData Classificationpii
ReasonPolicy type determines whether the cash surrender value is countable as a liquid asset.
application.assets[].companyNamestringtype = insurancesnap medicaidData Classificationpii
ReasonInsurance company name for policy verification and cash value lookup.
application.assets[].policyNumberstringtype = insurancesnap medicaidData Classificationpii
ReasonPolicy number required for insurance verification and cash value determination.
application.assets[].faceValuenumbertype = insurancesnap medicaidData Classificationpii
ReasonFace value is the starting point for determining cash surrender value; policies with face value above the exemption threshold have their cash value counted.
application.assets[].isRevocablebooleantype = insurancesnap medicaidData Classificationpii
ReasonOnly revocable life insurance policies have a countable cash surrender value; irrevocable policies are generally exempt.
application.assets[].addressAddresstype = real_propertysnap medicaidData Classificationpii
ReasonProperty address used for valuation and to determine whether the property is the primary residence (which may be exempt).
application.assets[].address.addressLine1stringtype = real_propertyapplication.assets[].address.addressLine2stringtype = real_propertyapplication.assets[].address.citystringtype = real_propertyapplication.assets[].address.statestringtype = real_propertyapplication.assets[].address.zipstringtype = real_propertyapplication.assets[].address.countystringtype = real_propertyapplication.assets[].primaryUseenumtype = real_propertyprimary_residence rental self_employment for_sale othersnap medicaidData Classificationpii
ReasonPrimary use determines exemption status — primary residences are exempt; rental and investment properties are countable.
application.assets[].primaryUseOtherstringtype = real_propertysnap medicaidData Classificationpii
ReasonCaptures non-enumerated primary uses for worker review.
AssetDisposal
application.assetDisposals[]list(AssetDisposal)Programssnap
ReasonRecords of assets transferred or disposed of within the lookback period, reviewed to determine whether the transfer was for less than fair market value.
application.assetDisposals[].iduuidProgramssnap
ReasonUnique identifier for the asset disposal record.
application.assetDisposals[].memberIduuid(ApplicationMember)Programssnap
ReasonFK to application.members[] linking this disposal to the household member who made the transfer.
application.assetDisposals[].applicationIduuid(Application)Programssnap
application.assetDisposals[].typeenumliquid vehicle real_property retirement_account insurance otherProgramssnap
ReasonType of transferred asset determines which countability rules apply to the transfer.
application.assetDisposals[].typeOtherstringProgramssnap
ReasonCaptures non-enumerated transferred asset types for worker review.
application.assetDisposals[].dateOfDisposaldateProgramssnap
ReasonDate of transfer determines whether the transfer falls within the applicable lookback period for the asset test.
application.assetDisposals[].amountReceivednumberProgramssnap
ReasonAmount received for the transfer; compared against fair market value to determine whether the transfer was for less than fair market value.
application.assetDisposals[].fairMarketValuenumberProgramssnap
ReasonFair market value at time of transfer; if the amount received is below fair market value, the difference may be counted as a resource.
Expense
application.expenses[]list(Expense)snap medicaidReasonExpense records for household members — shelter, dependent care, medical, child support, and alimony — used to calculate SNAP net income deductions and Medicaid spend-down amounts.
application.expenses[].iduuidsnap medicaidReasonUnique identifier for the expense record.
application.expenses[].memberIduuid(ApplicationMember)snap medicaidReasonFK to application.members[] linking this expense to the household member who incurs it.
application.expenses[].applicationIduuid(Application)snap medicaidapplication.expenses[].typeenumrent mortgage dependent_care medical child_support alimony othersnap medicaidReasonExpense type determines which deduction rules apply for SNAP net income calculation and which expenses are counted for Medicaid spend-down.
application.expenses[].typeOtherstringsnap medicaidReasonCaptures non-enumerated expense types for worker review.
application.expenses[].amountnumbersnap medicaidReasonActual amount paid for the expense, used in the deduction calculation.
application.expenses[].legallyObligatedAmountnumbersnap medicaidReasonOnly the legally obligated portion of child support and alimony payments is deductible from SNAP income; voluntary payments above the obligation are not deductible.
DisabilityBenefit
application.disabilityBenefits[]list(DisabilityBenefit)Programsmedicaid
ReasonSSI and SSDI benefit records for household members, used for categorical Medicaid eligibility screening, income counting, and Medicare Part A entitlement determination.
application.disabilityBenefits[].iduuidProgramsmedicaid
ReasonUnique identifier for the disability benefit record.
application.disabilityBenefits[].memberIduuid(ApplicationMember)Programsmedicaid
ReasonFK to application.members[] linking this benefit record to the household member.
application.disabilityBenefits[].applicationIduuid(Application)Programsmedicaid
application.disabilityBenefits[].programTypeenumssi ssdiProgramsmedicaid
ReasonSSI or SSDI — determines the eligibility pathway and income counting rules. SSI receipt confers categorical Medicaid eligibility in most states; SSDI affects income counting and Medicare entitlement.
application.disabilityBenefits[].statusenumpending approved active ended denied appealedProgramsmedicaid
ReasonCurrent benefit status; pending applications affect categorical eligibility screening, active and ended statuses affect income counting.
application.disabilityBenefits[].applicationDatedateProgramsmedicaid
ReasonDate of SSI/SSDI application used for determining the benefit start date if approved and for tracking pending applications.
application.disabilityBenefits[].startDatedateProgramsmedicaid
ReasonBenefit start date used for income counting and Medicare Part A entitlement determination.
application.disabilityBenefits[].endDatedateProgramsmedicaid
ReasonBenefit end date used to identify members with a history of SSI or SSDI and to assess whether continued eligibility applies.
Deduction
application.deductions[]list(Deduction)medicaid chipReasonAbove-the-line tax deductions for MAGI income calculation, stored per member to support accurate per-member income attribution.
ModelingSome intake forms do not collect per-member deduction attribution; in those cases the adapter assigns deduction records to the primary applicant or the tax filer. States whose forms collect per-member attribution should map directly to that member.
application.deductions[].iduuidmedicaid chipReasonUnique identifier for the deduction record.
application.deductions[].memberIduuid(ApplicationMember)medicaid chipReasonFK to application.members[] attributing this deduction to a specific household member for MAGI income calculation.
application.deductions[].applicationIduuid(Application)medicaid chipapplication.deductions[].typeenumalimony_paid capital_losses early_withdrawal_penalty student_loan_interest domestic_production_activities reimbursement_of_expenses hsa_deduction moving_expenses traditional_ira_contribution reservist_performing_artist_government_official_expenses other prior_periodmedicaid chipReasonAbove-the-line deduction type determines eligibility and the deductible amount under MAGI income calculation rules. The prior_period type captures the summarized total of above-the-line deductions paid earlier in the current tax year.
ModelingStored at the application level with a memberId FK for per-member attribution. When a state's intake form does not associate deductions with specific members, the adapter should assign deduction records to the primary applicant. For prior_period records, only amount is relevant and all other fields are inapplicable.
application.deductions[].typeOtherstringmedicaid chipReasonCaptures non-enumerated deduction types for adapter mapping and worker review.
application.deductions[].frequencyenumone_time_only weekly every_two_weeks twice_monthly monthly yearly variablemedicaid chipReasonFrequency is needed to normalize the deduction amount for annualized MAGI income calculation.
application.deductions[].amountnumbermedicaid chipReasonPer-period deduction amount; combined with frequency to calculate the annual deduction figure.
application.deductions[].annualAmountnumbermedicaid chipReasonProjected annual deduction used directly in the MAGI calculation. Populated when frequency is variable and the per-period amount cannot be reliably annualized.
Verification
application.verifications[]list(Verification)snap medicaidReasonThe household's verification checklist — one item per verification obligation, covering both electronic service check results and paper document requirements on a single lifecycle. Created automatically by state machine event handlers at submission.
application.verifications[].applicationIduuid(Application)snap medicaidapplication.verifications[].sourceIduuid(Polymorphic)snap medicaidReasonID of the specific record that triggered this verification obligation (e.g., a specific income or member record). Null for household-level obligations.
application.verifications[].reviewedByuuidsnap medicaidapplication.verifications[].iduuidsnap medicaidapplication.verifications[].statusenumpending inconclusive satisfied waived cannot_verifysnap medicaidReasonCurrent lifecycle status of the verification obligation — pending, inconclusive, satisfied, waived, or cannot_verify. Read-only; set by the rules engine.
application.verifications[].evidence[]stringsnap medicaidReasonElectronic and document evidence items accumulated against this obligation. Populated as checks run and documents are received.
application.verifications[].documentRequests[]list(VerificationDocumentRequest)snap medicaidReasonOutbound notices requesting documents from the applicant for this obligation. Populated when an electronic check is inconclusive and a document request is sent.
application.verifications[].documentRequests[].noticeIduuid(External)snap medicaidReasonID of the notice in the communication domain, used to track delivery and link back to the outbound notice record.
application.verifications[].documentRequests[].typeenumdocument_request_citizenship_verification document_request_identity_verification document_request_immigration_verification document_request_income_verification document_request_residency_verificationsnap medicaidReasonTemplate identifier for the notice, matching the type field on the communication.notice.sent event (e.g., document_request_income_verification).
application.verifications[].documentRequests[].sentAtdatetimesnap medicaidReasonWhen the document request notice was sent; used to calculate response deadlines and track aging obligations.
application.verifications[].documentRequests[].dueAtdatetimesnap medicaidReasonDeadline by which the applicant must respond with documents. Null if no deadline was set.
application.verifications[].documentRequests[].channelenumemail in_person mail portal nullsnap medicaidReasonChannel through which the document request notice was sent — email, in_person, or mail.
application.verifications[].sourceTypeenummember incomesnap medicaidReasonIdentifies what sourceId refers to — member or income. Required when sourceId is set; null for household-level obligations.
application.verifications[].categoryenumcitizenship identity immigration income residencysnap medicaidReasonVerification obligation category — citizenship, identity, immigration, income, or residency — determines which document types and electronic checks are applicable.
application.verifications[].verificationTypeenumdocument electronicsnap medicaidReasonHow this obligation is to be fulfilled — document (paper evidence from applicant) or electronic (automated service check).
application.verifications[].reviewedAtdatetimesnap medicaidInterview
application.interview.applicationIduuid(Application)Programssnap
application.interview.appointments[]uuid(External)Programssnap
ReasonAppointment IDs from the scheduling domain accumulated for this interview obligation. Populated by the rules engine when a scheduling event fires; one interview obligation may span multiple appointments due to rescheduling or no-shows.
application.interview.iduuidProgramssnap
application.interview.waiverStatusenumpending granted deniedProgramssnap
ReasonStatus of the interview waiver for this applicant. Caseworker-set field.
application.interview.waiverReasonstringProgramssnap
ReasonReason the interview was waived. Required when waiverStatus is granted; used for audit and supervisory review.
application.interview.completedAtdatetimeProgramssnap
ReasonWhen the caseworker attested the interview obligation was satisfied. Not set automatically — requires explicit caseworker action to record which appointment fulfilled the regulatory obligation.
ReviewProgressListResponse
application.reviewProgress[]list(ReviewProgressListResponse)application.reviewProgress[].items[]list(ReviewProgress)application.reviewProgress[].items[].iduuidapplication.reviewProgress[].items[].itemIduuid(Polymorphic)application.reviewProgress[].items[].statusenumnot_started in_progress complete flaggedapplication.reviewProgress[].items[].notesobjectapplication.reviewProgress[].items[].notes.textstringapplication.reviewProgress[].items[].notes.textFormatenumplain markdown htmlapplication.reviewProgress[].items[].sectionenumdemographics identity income employment health-coverage assets contact expenses householdapplication.reviewProgress[].totalintegerapplication.reviewProgress[].limitintegerapplication.reviewProgress[].offsetintegerapplication.reviewProgress[].hasNextboolean