reason
339 annotations
schema
application.assetDisposals[]
Records of assets transferred or disposed of within the lookback period, reviewed to determine whether the transfer was for less than fair market value.
schema
application.assetDisposals[].amountReceived
Amount received for the transfer; compared against fair market value to determine whether the transfer was for less than fair market value.
schema
application.assetDisposals[].dateOfDisposal
Date of transfer determines whether the transfer falls within the applicable lookback period for the asset test.
schema
application.assetDisposals[].fairMarketValue
Fair market value at time of transfer; if the amount received is below fair market value, the difference may be counted as a resource.
schema
application.assetDisposals[].id
Unique identifier for the asset disposal record.
schema
application.assetDisposals[].memberId
FK to application.members[] linking this disposal to the household member who made the transfer.
schema
application.assetDisposals[].type
Type of transferred asset determines which countability rules apply to the transfer.
schema
application.assetDisposals[].typeOther
Captures non-enumerated transferred asset types for worker review.
schema
application.assets[]
Asset records for household members — liquid assets, vehicles, real property, retirement accounts, and insurance — used in the SNAP asset test and Medicaid resource determination.
schema
application.assets[].accountNumber
Account number for liquid asset verification and cross-matching.
schema
application.assets[].address
Property address used for valuation and to determine whether the property is the primary residence (which may be exempt).
schema
application.assets[].companyName
Insurance company name for policy verification and cash value lookup.
schema
application.assets[].faceValue
Face value is the starting point for determining cash surrender value; policies with face value above the exemption threshold have their cash value counted.
schema
application.assets[].financialInstitutionName
Financial institution name for liquid asset verification through bank statements or electronic verification.
schema
application.assets[].id
Unique identifier for the asset record.
schema
application.assets[].isRevocable
Only revocable life insurance policies have a countable cash surrender value; irrevocable policies are generally exempt.
schema
application.assets[].make
Vehicle make used with year and model for fair market value determination.
schema
application.assets[].memberId
FK to application.members[] linking this asset to the household member who owns it.
schema
application.assets[].model
Vehicle model used with year and make for fair market value determination.
schema
application.assets[].policyNumber
Policy number required for insurance verification and cash value determination.
schema
application.assets[].policyType
Policy type determines whether the cash surrender value is countable as a liquid asset.
schema
application.assets[].primaryUse
Primary use determines exemption status — primary residences are exempt; rental and investment properties are countable.
schema
application.assets[].primaryUseOther
Captures non-enumerated primary uses for worker review.
schema
application.assets[].type
Asset type determines which countability rules apply and what verification is required.
schema
application.assets[].typeOther
Captures non-enumerated asset types for worker review and manual classification.
schema
application.assets[].value
Current market value of the asset, used in the SNAP asset test and Medicaid resource determination.
schema
application.assets[].year
Vehicle year is used with make and model to determine fair market value for the SNAP vehicle asset test.
schema
application.channel
How the application was filed; used for intake channel reporting and to route applications to appropriate processing queues.
schema
application.childSupport.goodCauseChildSupportWaiver
Applicants who cooperate with child support enforcement may claim a good cause exception if cooperation would put them or their children at risk of harm.
schema
application.childSupport.parentsOutsideHome[]
Non-custodial parents outside the home identified for child support enforcement referral, which is a condition of TANF receipt.
schema
application.childSupport.parentsOutsideHome[].attemptedMedicalSupportCooperation
Medicaid applicants are required to cooperate with medical support enforcement as a condition of eligibility.
schema
application.childSupport.parentsOutsideHome[].children[]
Identifies which children in the household are associated with this non-custodial parent for child support enforcement purposes.
schema
application.childSupport.parentsOutsideHome[].children[].id
Identifier of the referenced child person record.
schema
application.childSupport.parentsOutsideHome[].children[].type
Discriminator identifying whether the child is a household member or a contact-only person record.
schema
application.childSupport.parentsOutsideHome[].id
Identifier of the referenced person record for the non-custodial parent; the person record holds their name, address, and phone for enforcement contact.
schema
application.childSupport.parentsOutsideHome[].type
Discriminator identifying whether the non-custodial parent is a household member or a contact-only person record in application.contacts[].
schema
application.contacts[]
Registry 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.
schema
application.contacts[].email
Email address for electronic correspondence, used for non-member contacts who opt in to electronic notices.
schema
application.contacts[].id
Unique identifier for the person record; referenced throughout the model via member|contact discriminator pairs (type + id).
schema
application.contacts[].name
Legal name of the person for identity verification, correspondence, and data matching across programs.
schema
application.contacts[].primaryAddress
Mailing address for correspondence directed to this person, used when the person is a non-member contact such as an authorized representative or sponsor.
schema
application.contacts[].primaryPhone
Contact phone number for this person, used for non-member contacts such as authorized representatives and helpers.
schema
application.deductions[]
Above-the-line tax deductions for MAGI income calculation, stored per member to support accurate per-member income attribution.
schema
application.deductions[].amount
Per-period deduction amount; combined with frequency to calculate the annual deduction figure.
schema
application.deductions[].annualAmount
Projected annual deduction used directly in the MAGI calculation. Populated when frequency is variable and the per-period amount cannot be reliably annualized.
schema
application.deductions[].frequency
Frequency is needed to normalize the deduction amount for annualized MAGI income calculation.
schema
application.deductions[].id
Unique identifier for the deduction record.
schema
application.deductions[].memberId
FK to application.members[] attributing this deduction to a specific household member for MAGI income calculation.
schema
application.deductions[].type
Above-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.
schema
application.deductions[].typeOther
Captures non-enumerated deduction types for adapter mapping and worker review.
schema
application.deniesIevsConsent
Applicants may opt out of income and asset verification against federal data sources. Denial does not disqualify but triggers manual verification.
schema
application.disabilityBenefits[]
SSI and SSDI benefit records for household members, used for categorical Medicaid eligibility screening, income counting, and Medicare Part A entitlement determination.
schema
application.disabilityBenefits[].applicationDate
Date of SSI/SSDI application used for determining the benefit start date if approved and for tracking pending applications.
schema
application.disabilityBenefits[].endDate
Benefit end date used to identify members with a history of SSI or SSDI and to assess whether continued eligibility applies.
schema
application.disabilityBenefits[].id
Unique identifier for the disability benefit record.
schema
application.disabilityBenefits[].memberId
FK to application.members[] linking this benefit record to the household member.
schema
application.disabilityBenefits[].programType
SSI 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.
schema
application.disabilityBenefits[].startDate
Benefit start date used for income counting and Medicare Part A entitlement determination.
schema
application.disabilityBenefits[].status
Current benefit status; pending applications affect categorical eligibility screening, active and ended statuses affect income counting.
schema
application.ebt.deliveryPreference
Determines whether the EBT card is mailed or held for in-person pickup.
schema
application.ebt.needsCard
Collected at intake to trigger EBT card issuance at approval without a separate request.
schema
application.expeditedSnap.monthlyMortgage
Monthly shelter costs are compared against income and cash for the expedited SNAP destitution test.
schema
application.expeditedSnap.monthlyRent
Monthly shelter costs are compared against income and cash for the expedited SNAP destitution test.
schema
application.expeditedSnap.monthlyUtilities
Monthly utility costs combined with shelter costs are compared against income for the expedited SNAP destitution test.
schema
application.expeditedSnap.receivedSnapInLast30Days
Recent SNAP receipt in another state may indicate duplicate participation or ongoing eligibility that affects expedited processing.
schema
application.expeditedSnap.totalCashOnHand
Cash and liquid assets are combined with income for the expedited SNAP screening test.
schema
application.expeditedSnap.totalMoneyExpectedThisMonth
Gross monthly income is compared against the expedited SNAP threshold to determine whether same-day issuance is required.
schema
application.expenses[]
Expense records for household members — shelter, dependent care, medical, child support, and alimony — used to calculate SNAP net income deductions and Medicaid spend-down amounts.
schema
application.expenses[].amount
Actual amount paid for the expense, used in the deduction calculation.
schema
application.expenses[].id
Unique identifier for the expense record.
schema
application.expenses[].legallyObligatedAmount
Only the legally obligated portion of child support and alimony payments is deductible from SNAP income; voluntary payments above the obligation are not deductible.
schema
application.expenses[].memberId
FK to application.members[] linking this expense to the household member who incurs it.
schema
application.expenses[].type
Expense type determines which deduction rules apply for SNAP net income calculation and which expenses are counted for Medicaid spend-down.
schema
application.expenses[].typeOther
Captures non-enumerated expense types for worker review.
schema
application.healthEnrollments[]
Join 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.
schema
application.healthEnrollments[].eligibleDate
Date the member becomes eligible for coverage; used to determine whether a special enrollment period applies.
schema
application.healthEnrollments[].endDate
Date coverage lapsed, triggering special enrollment period eligibility for marketplace.
schema
application.healthEnrollments[].enrollmentStatus
Distinguishes 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.
schema
application.healthEnrollments[].healthPlanId
FK to application.healthPlans[] identifying the plan this member is enrolled in.
schema
application.healthEnrollments[].id
Unique identifier for the enrollment record.
schema
application.healthEnrollments[].jobId
FK to application.jobs[] linking an employer-sponsored enrollment to the specific job, enabling employer contact lookup without duplicating employer data.
schema
application.healthEnrollments[].memberId
FK to members[] identifying the household member enrolled in this plan.
schema
application.healthEnrollments[].prefersSeparateMailing
Members have the right to request that health coverage notices be sent to an alternative address, primarily for domestic violence safety and health information privacy.
schema
application.healthEnrollments[].role
Subscriber vs. dependent role affects premium attribution for the ACA employer coverage affordability test.
schema
application.healthEnrollments[].startDate
Coverage start date; used to determine coverage gap periods relevant to MEC analysis and special enrollment eligibility.
schema
application.healthPlans[]
Health 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[].
schema
application.healthPlans[].coverageContact
HR or benefits contact at the employer for plan verification and enrollment period confirmation.
schema
application.healthPlans[].hasMinimumValuePlan
An employer plan that meets minimum value (covers at least 60% of costs) blocks marketplace premium tax credit eligibility.
schema
application.healthPlans[].id
Unique identifier for the health plan record; FK target for application.healthEnrollments[].healthPlanId.
schema
application.healthPlans[].insuranceCompanyName
Insurance carrier for TRICARE supplemental or managed care plans, required for coordination of benefits.
schema
application.healthPlans[].lowestCostPlanName
Identifies the lowest-cost minimum value plan offered by the employer, used in the affordability test.
schema
application.healthPlans[].medicareId
Medicare Beneficiary Identifier (MBI) is required for all Medicare processing. One MBI covers all parts for a beneficiary.
schema
application.healthPlans[].organizationId
FK to application.organizations[] for employer-sponsored and COBRA plans, linking the plan to the employer organization record without duplicating employer contact data.
schema
application.healthPlans[].partA.startDate
Part A effective date used for coordination with Medicaid and the Medicare Savings Program.
schema
application.healthPlans[].partA.status
Entitled 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.
schema
application.healthPlans[].partB.startDate
Part B effective date used for late enrollment penalty calculation and MSP coordination.
schema
application.healthPlans[].partB.status
Part B enrollment status affects MSP eligibility and late enrollment penalty determination.
schema
application.healthPlans[].partC.contractId
CMS contract ID uniquely identifies the Medicare Advantage organization. Required for plan identification in CMS enrollment data.
schema
application.healthPlans[].partC.planId
CMS plan ID combined with contract ID uniquely identifies the specific Medicare Advantage plan.
schema
application.healthPlans[].partC.planName
Human-readable Medicare Advantage plan name for applicant correspondence and worker review.
schema
application.healthPlans[].partC.startDate
Part C effective date for coordination with Medicaid dual-eligible programs.
schema
application.healthPlans[].partC.status
Part C (Medicare Advantage) enrollment status; a Part C enrollee receives Parts A and B benefits through the plan.
schema
application.healthPlans[].partD.planName
Prescription drug plan name for coordination of benefits identification.
schema
application.healthPlans[].partD.startDate
Part D effective date for coordination with Medicaid drug coverage.
schema
application.healthPlans[].partD.status
Part D prescription drug coverage status for coordination of benefits.
schema
application.healthPlans[].policyNumber
Policy number required for benefits verification and coordination of benefits.
schema
application.healthPlans[].programType
Identifies the specific federal health program (TRICARE, VA, Peace Corps, etc.) for verification and MEC determination.
schema
application.healthPlans[].sponsor.id
Identifier of the referenced person record for the TRICARE military sponsor.
schema
application.healthPlans[].sponsor.type
Discriminator identifying whether the TRICARE military sponsor is a household member or a contact-only person record in application.contacts[].
schema
application.healthPlans[].type
Coverage type determines minimum essential coverage (MEC) status, marketplace eligibility, and Medicare Savings Program (MSP) screening.
schema
application.healthPlans[].typeOther
Captures non-enumerated coverage types for adapter review and manual classification.
schema
application.householdInfo.isSubsidizedHousing
Residents of federally subsidized housing are ineligible for the heating and cooling standard utility allowance.
schema
application.householdInfo.receivedTanfInAnotherState
Cross-state TANF receipt is verified to prevent duplicate participation and enforce time limits across states.
schema
application.householdInfo.roomers[]
Identifies roomers and boarders in the home who are not SNAP household members because they purchase and prepare food separately.
schema
application.householdInfo.roomers[].amountPaidForRent
Rent paid by a roomer is income to the household; distinguishes market-rate roomers from boarders.
schema
application.householdInfo.roomers[].id
Identifier of the referenced person record; points to application.members[].id when type = member, or application.contacts[].id when type = contact.
schema
application.householdInfo.roomers[].mealsIncludedWithRent
When meals are included, the person is a boarder; meal revenue is income. When meals are not included, rent revenue is income.
schema
application.householdInfo.roomers[].type
Discriminator identifying whether the roomer is a household member or a contact-only person record in application.contacts[].
schema
application.householdInfo.utilitiesIncludedInRent
When utilities are included in rent, the household may not claim a utility standard deduction for SNAP.
schema
application.incomes[]
Income 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).
schema
application.incomes[].amount
The income amount for the given frequency period, used as the basis for all income calculations.
schema
application.incomes[].changeExplanation
Free-text narrative explaining an income change; required by MAGI rules when projected income differs materially from annualized pay stubs.
schema
application.incomes[].changeReason
Categorical reason for a recent income change, used for case worker review and to validate projected annual income under MAGI rules.
schema
application.incomes[].dateReceived
Date of receipt required for lump sum income to determine which benefit month is affected by the payment.
schema
application.incomes[].frequency
Frequency 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.
schema
application.incomes[].id
Unique identifier for the income record.
schema
application.incomes[].inKindSupportType
Type of in-kind support received — shelter, food, utilities, or other — determines the applicable income counting rule and SSI valuation method.
schema
application.incomes[].jobId
FK to application.jobs[] linking employed income to the specific job that generated it. Enables per-job income calculation when a member holds multiple jobs.
schema
application.incomes[].lumpSumType
Lump sum type determines how the payment is treated across programs — some types are excluded, others are counted in the month of receipt or prorated.
schema
application.incomes[].memberId
FK to application.members[] linking this income record to the household member who receives it.
schema
application.incomes[].payerName
Name of the person or organization providing in-kind support, for verification and determination of whether support is from a sponsor subject to deeming rules.
schema
application.incomes[].type
Income type determines the calculation method, applicable exclusions, verification requirements, and program-specific treatment.
schema
application.incomes[].typeOther
Captures non-enumerated income types for adapter mapping and worker review.
schema
application.incomes[].unearnedType
Specific unearned income type determines exclusion rules, verification source, and program-specific counting treatment.
schema
application.interview.appointments[]
Appointment 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.
schema
application.interview.completedAt
When the caseworker attested the interview obligation was satisfied. Not set automatically — requires explicit caseworker action to record which appointment fulfilled the regulatory obligation.
schema
application.interview.waiverReason
Reason the interview was waived. Required when waiverStatus is granted; used for audit and supervisory review.
schema
application.interview.waiverStatus
Status of the interview waiver for this applicant. Caseworker-set field.
schema
application.jobs[]
Employment records for household members, covering both employed and self-employed income sources. Each record represents one job and links to income records via jobId.
schema
application.jobs[].businessName
Trade name or DBA name of the self-employment business for verification and worker review.
schema
application.jobs[].businessType
Type of self-employment business may affect which expense categories are allowable deductions.
schema
application.jobs[].employerId
FK 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.
schema
application.jobs[].endDate
Employment end date used to identify recent job loss for expedited processing screening and income change evaluation.
schema
application.jobs[].endReason
Voluntary separation without good cause may result in TANF disqualification; participation in a labor strike disqualifies the striking member from SNAP.
schema
application.jobs[].expenses.costOfMerchandise
Cost of goods or merchandise sold is an allowable deduction from self-employment gross income.
schema
application.jobs[].expenses.interest
Business interest payments are an allowable deduction from self-employment gross income.
schema
application.jobs[].expenses.laborCosts
Gross labor costs paid to employees are an allowable deduction from self-employment gross income.
schema
application.jobs[].expenses.other
Other allowable business expenses not captured in the enumerated categories, subject to worker review.
schema
application.jobs[].expenses.taxes
Business taxes paid are an allowable deduction from self-employment gross income.
schema
application.jobs[].expenses.utilities
Utility costs paid for business use are an allowable deduction from self-employment gross income.
schema
application.jobs[].hoursPerWeek
Average weekly hours used for TANF work participation rate calculation and SNAP ABAWD employment exemption determination.
schema
application.jobs[].id
Unique identifier for the job record; FK target for application.incomes[].jobId and application.healthEnrollments[].jobId.
schema
application.jobs[].isTemporary
Temporary employment affects SNAP income averaging rules and TANF work activity categorization.
schema
application.jobs[].lastPaycheckDate
Date of last paycheck required to determine the income counting period when employment recently ended.
schema
application.jobs[].lastPaycheckGrossAmount
Gross amount of last paycheck used for income verification when pay stubs from the current period are unavailable.
schema
application.jobs[].memberId
FK to members[] linking this job to the household member who holds it.
schema
application.jobs[].reportingMonth
The 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.
schema
application.jobs[].startDate
Employment start date used to verify duration and determine which income is countable in the current benefit period.
schema
application.jobs[].status
Current employment status; on_strike triggers SNAP household strike disqualification rules for the striking member.
schema
application.jobs[].strikeStartDate
Date the labor strike began; used to determine whether the SNAP strike disqualification period applies and to establish the duration of the disqualification.
schema
application.jobs[].type
Employed vs. self-employed status determines the income calculation method, allowable expense deductions, and applicable verification documents.
schema
application.members[]
Household 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.
schema
application.members[].citizenship.certificateNumber
US naturalization or citizenship certificate number used for SAVE verification of citizenship claims.
schema
application.members[].citizenship.citizenshipStatus
Non-citizens have restricted access to federal programs under PRWORA. Citizenship status determines which verification procedures and waiting periods apply.
schema
application.members[].citizenship.document.countryOfIssuance
Country of issuance is required for foreign passport VLP verification lookups.
schema
application.members[].citizenship.document.expirationDate
Expired immigration documents may indicate a change in immigration status that affects eligibility.
schema
application.members[].citizenship.document.number
Document number required for FDSH VLP immigration status verification.
schema
application.members[].citizenship.document.type
Immigration document type determines which fields FDSH VLP requires to initiate a verification check.
schema
application.members[].citizenship.hasQualifyingMilitaryConnection
Qualified non-citizens with a connection to US military service are exempt from PRWORA waiting periods.
schema
application.members[].citizenship.immigrantStatus
Specific immigration category determines program eligibility, applicable waiting periods, and the required verification pathway.
schema
application.members[].citizenship.residedInUsSince1996
Continuous 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.
schema
application.members[].citizenship.sponsored.hasBeenAbandonedBySponsor
Sponsor abandonment is a basis for exempting a sponsored non-citizen from deeming of the sponsor's income.
schema
application.members[].citizenship.sponsored.hasBeenMistreatedBySponsor
Battery or extreme cruelty by a sponsor is a basis for exempting a sponsored non-citizen from deeming under VAWA protections.
schema
application.members[].citizenship.sponsored.qualifiesForSponsorDeemingException
Certain sponsored non-citizens — pregnant women, children under 21 — are exempt from sponsor income deeming.
schema
application.members[].citizenship.sponsored.receivesInKindSupport
In-kind support and maintenance (non-cash housing and food) from a sponsor is counted as income for SSI and may affect other program determinations.
schema
application.members[].citizenship.uscisNumberOrI94
Alien registration number or I-94 admission number required to initiate FDSH VLP verification.
schema
application.members[].contact.alternateNoticeAddress
Alternative 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.
schema
application.members[].contact.alternatePhone
Secondary contact number used when the primary number is unavailable.
schema
application.members[].contact.email
Email address for electronic delivery of program notices when noticePreference includes email.
schema
application.members[].contact.isExperiencingHomelessness
Homelessness affects address collection requirements, shelter deduction eligibility for SNAP, and may trigger expedited processing.
schema
application.members[].contact.mailingAddress
Used for correspondence when the mailing address differs from the home address.
schema
application.members[].contact.noticePreference
Determines whether notices are delivered by paper mail, email, or both, per applicant preference.
schema
application.members[].contact.primaryAddress
Used for residency determination, county routing for benefits administration, and physical location for home visits when required.
schema
application.members[].contact.primaryPhone
Primary contact number for program notifications, interview scheduling, and verification follow-up.
schema
application.members[].disability.hasLongTermCondition
Identifies 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.
schema
application.members[].disability.hasMentalDisability
Identifies whether the member has a mental disability; collected alongside hasPhysicalDisability to support SNAP and Medicaid disability determinations.
schema
application.members[].disability.hasPhysicalDisability
Identifies whether the member has a physical disability; collected to support SNAP elderly and disabled household deductions and Medicaid disability pathways.
schema
application.members[].disability.isDisabled
A disabling condition lasting 12 or more months affects SNAP elderly and disabled household rules and categorical Medicaid eligibility determination.
schema
application.members[].disability.needsHelpWithSelfCare
Identifies 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.
schema
application.members[].fosterCare.endDate
End 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.
schema
application.members[].fosterCare.exitReason
Exit reason determines eligibility pathway — aged-out youth qualify for extended Medicaid; reunification and adoption have different eligibility implications.
schema
application.members[].fosterCare.exitState
State in which the member was in foster care; required for cross-state Medicaid eligibility for youth who aged out in another state.
schema
application.members[].fosterCare.receivedMedicaidAtAge18
Youth who were enrolled in Medicaid at age 18 qualify for extended Medicaid coverage to age 26 regardless of current income.
schema
application.members[].fosterCare.returnDate
Date of re-entry into foster care after adoption dissolution; used to determine whether extended Medicaid eligibility resumes.
schema
application.members[].fosterCare.returnedAfterAdoption
Youth who re-enter foster care after an adoption dissolution may regain extended Medicaid eligibility; this flag triggers review of the re-entry date.
schema
application.members[].fosterCare.startDate
Start date of the most recent foster care episode; used with end date and member age to determine whether extended Medicaid eligibility applies.
schema
application.members[].hasThirdPartyLiabilityClaim
Medicaid is payer of last resort; the presence of a third-party liability claim triggers cost avoidance and recovery procedures.
schema
application.members[].id
Unique identifier for the member record; FK target for memberId fields throughout the application model.
schema
application.members[].institutionalStatus.dateEntered
Entry date used to determine the period of ineligibility and whether a partial-month benefit applies.
schema
application.members[].institutionalStatus.facilityName
Facility name used for verification and for determining the institution type when not explicitly collected.
schema
application.members[].institutionalStatus.facilityType
Facility type determines which program restrictions apply — incarcerated individuals are ineligible for SNAP and Medicaid during incarceration.
schema
application.members[].institutionalStatus.livesInInstitution
Institutionalized individuals are generally ineligible for SNAP and have restricted Medicaid eligibility under IMD exclusion and LTSS rules.
schema
application.members[].institutionalStatus.mealsProvided
Institutions that provide meals may constitute a separate food purchasing unit, affecting SNAP household composition.
schema
application.members[].institutionalStatus.pendingDispositionOfCharges
Individuals detained pending disposition of charges retain Medicaid eligibility; convicted and incarcerated individuals do not.
schema
application.members[].isMigrantFarmWorker
Migrant and seasonal farm workers qualify for expedited SNAP regardless of the standard income and asset thresholds.
schema
application.members[].military.dischargeStatus
Dishonorable discharge is a categorical disqualifier for SNAP; any member with a dishonorable discharge is ineligible regardless of other criteria.
schema
application.members[].military.isActiveDuty
Active duty status affects SNAP income treatment for military households and may affect TANF work activity exemptions.
schema
application.members[].military.isVeteran
Veteran status may affect categorical SNAP eligibility in states with broad-based categorical eligibility and may affect Medicaid when TRICARE is present.
schema
application.members[].personalInformation.dateOfBirth
Used for age-based eligibility rules including CHIP age limits, SNAP elderly and disabled deductions, ABAWD rules, and foster care extended eligibility.
schema
application.members[].personalInformation.genderIdentity
Required to honor anti-discrimination obligations and ensure accurate, respectful correspondence with applicants.
schema
application.members[].personalInformation.isHispanicOrLatino
Hispanic or Latino ethnicity is collected separately from race per OMB standards and is required for civil rights reporting.
schema
application.members[].personalInformation.maritalStatus
Affects household composition, spousal income deeming, MAGI filing status determination, and two-parent TANF household rules.
schema
application.members[].personalInformation.preferredSpokenLanguage
Determines which language interpreter services must be arranged for appointments and communications to ensure meaningful access.
schema
application.members[].personalInformation.preferredWrittenLanguage
Determines which language translated notices and written communications must be provided in for meaningful access.
schema
application.members[].personalInformation.races[]
Required for civil rights reporting, equity monitoring, and program targeting.
schema
application.members[].personalInformation.sexAssignedAtBirth
Used for clinical eligibility determinations including pregnancy Medicaid, sex-specific health screenings, and certain household composition rules.
schema
application.members[].personalInformation.ssn
Required for identity verification and cross-matching against federal income and asset data sources under IEVS.
schema
application.members[].personId
FK to application.contacts[] linking the member to their person record, which holds name, address, phone, and email shared with non-member contacts.
schema
application.members[].personMatch
Person matching state for an application member. Populated when the client management domain resolves a match; null until matching begins.
schema
application.members[].personMatch.candidates[]
Match candidates returned by the person matching process. Populated for review_required; empty otherwise.
schema
application.members[].personMatch.candidates[].confidenceScore
Match confidence score from 0 (no confidence) to 1 (certain); used by caseworkers to prioritize candidate review.
schema
application.members[].personMatch.candidates[].personId
ID of the candidate person record in the client management domain.
schema
application.members[].personMatch.matchStatus
Outcome of the person matching process — confirmed (single high-confidence match), review_required (multiple candidates need caseworker review), or no_match.
schema
application.members[].pregnancy.dueDate
Due date determines the benefit period for pregnancy Medicaid and the anticipated household size change for SNAP.
schema
application.members[].pregnancy.isPregnant
Pregnancy confers categorical Medicaid eligibility and affects CHIP unborn child coverage; the expected baby counts as a household member for SNAP.
schema
application.members[].pregnancy.numberOfBabiesExpected
Each expected baby counts as a separate household member for SNAP and Medicaid household size calculation.
schema
application.members[].priorConvictions.convictedDuplicateSnapBenefits
Conviction for receiving duplicate SNAP benefits results in a disqualification period proportional to the offense.
schema
application.members[].priorConvictions.convictedOfDisqualifyingViolentCrime
Conviction for murder or certain sexual offenses results in permanent SNAP disqualification under the Agriculture Improvement Act.
schema
application.members[].priorConvictions.convictedOfSnapTrafficking
Conviction for trafficking SNAP benefits over $500 results in permanent disqualification.
schema
application.members[].priorConvictions.convictedTradingSnapForFirearmsOrExplosives
Conviction for trading SNAP benefits for firearms, ammunition, or explosives results in permanent disqualification.
schema
application.members[].priorConvictions.disqualifiedForIPV
A prior intentional program violation (IPV) disqualification carries over and may trigger an extended or permanent disqualification period.
schema
application.members[].priorConvictions.isFleeingFelon
Individuals fleeing to avoid prosecution or confinement for a felony are ineligible for SNAP and TANF.
schema
application.members[].priorConvictions.isViolatingProbationOrParole
Individuals violating probation or parole conditions are ineligible for SNAP and TANF.
schema
application.members[].programDeterminations[]
Per-program eligibility determination results for this member, populated by the rules engine at determination. One record per program evaluated.
schema
application.members[].programDeterminations[].determinedAt
When the determination was recorded by the rules engine.
schema
application.members[].programDeterminations[].outcome
Determination outcome — approved or denied — for this member/program combination.
schema
application.members[].programDeterminations[].program
Program identifier the determination applies to (e.g., snap, medicaid, tanf).
schema
application.members[].programsAppliedFor[]
Per-member program application, distinct from the household-level programsAppliedFor[]. A member may apply for a subset of the programs the household is seeking.
schema
application.members[].purchasesAndPreparesFood
Members 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.
schema
application.members[].residency.isStateResident
State residency is a universal eligibility requirement across all programs; non-residents are ineligible regardless of other criteria.
schema
application.members[].residency.stateResidencyDate
Required for states that verify residency duration and for determining benefit start dates when a household transfers from another state.
schema
application.members[].retroactiveMedicalCoverage.isRequested
Medicaid may cover medical expenses incurred up to 3 months before the application month for eligible individuals who would have qualified during that period.
schema
application.members[].retroactiveMedicalCoverage.periods[]
Monthly 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.
schema
application.members[].retroactiveMedicalCoverage.periods[].householdIncome
Income during the retroactive month must be evaluated against the eligibility threshold for that month to determine whether the applicant would have qualified.
schema
application.members[].retroactiveMedicalCoverage.periods[].month
Identifies the specific months for which retroactive coverage is requested, up to the 3-month retroactive period.
schema
application.members[].roles[]
Determines which application flows apply to the member and how their data is scoped within the application.
schema
application.members[].studentStatus.enrollmentStatus
Full-time students ages 18-49 are generally ineligible for SNAP unless they meet a specific exemption.
schema
application.members[].studentStatus.institutionType
The SNAP student eligibility restriction applies specifically to higher education; vocational training institutions may not trigger the restriction.
schema
application.members[].studentStatus.isParticipatingInWorkStudy
Participation in a federally funded work-study program is one of the exemptions from the SNAP student eligibility restriction.
schema
application.members[].studentStatus.schoolName
School name used to verify enrollment status and institution type for the SNAP student restriction.
schema
application.members[].tribalStatus.isAmericanIndianOrAlaskaNative
American Indian and Alaska Native members have special Medicaid and CHIP eligibility protections and are eligible for Indian Health Service coordination.
schema
application.members[].tribalStatus.tribeName
Tribe name used to verify tribal membership and coordinate with IHS and tribal health programs.
schema
application.members[].tribalStatus.tribeState
State where the tribe is located, used to identify the relevant IHS service area and tribal health program.
schema
application.organizations[]
Registry 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.
schema
application.organizations[].address
Organization's address for verification and contact when phone is unavailable.
schema
application.organizations[].ein
Employer Identification Number used for income verification and employer contact.
schema
application.organizations[].id
Unique identifier for the organization record; referenced by FK fields throughout the model.
schema
application.organizations[].name
Legal name of the organization for correspondence, verification, and reporting.
schema
application.organizations[].phone
Organization's phone number for income verification and plan enrollment contact.
schema
application.personRelationships[]
Directed 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.
schema
application.personRelationships[].from
Source person in a directed relationship; from IS THE [relationshipType] OF to.
schema
application.personRelationships[].from.id
Identifier of the source person record; points to application.members[].id when type = member, or application.contacts[].id when type = contact.
schema
application.personRelationships[].from.type
Discriminator identifying whether the source person is a household member or a contact-only person record.
schema
application.personRelationships[].relationshipTypes[]
Relationship 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.
schema
application.personRelationships[].to
Target person in a directed relationship.
schema
application.personRelationships[].to.id
Identifier of the target person record; points to application.members[].id when type = member, or application.contacts[].id when type = contact.
schema
application.personRelationships[].to.type
Discriminator identifying whether the target person is a household member or a contact-only person record.
schema
application.programsAppliedFor[]
Determines which eligibility rules to apply and drives federal and state reporting.
schema
application.registerToVote
Public benefits agencies are required to offer voter registration to applicants.
schema
application.signatures[]
Signature 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.
schema
application.signatures[].purpose
A single application may require multiple legally distinct signature events with different legal bases, signers, and timing.
schema
application.signatures[].signatureMethod
Distinguishes electronic, wet ink, and verbal signatures; states must track method for legal validity and audit purposes.
schema
application.signatures[].signedAt
Date and time of signature required for audit trail, benefit period determination, and legal validity.
schema
application.signatures[].signer.id
Identifier of the referenced person or organization record who is the signer.
schema
application.signatures[].signer.role
Identifies 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.
schema
application.signatures[].signer.type
Discriminator identifying whether the signer is a household member, a contact-only person, or an organization.
schema
application.sponsors[]
Immigration 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.
schema
application.sponsors[].householdSize
Sponsor household size is used in the deeming formula to calculate the sponsor's available income attributable to the sponsored non-citizen.
schema
application.sponsors[].id
Unique identifier for the sponsor record.
schema
application.sponsors[].income
Sponsor's gross income is the starting point for the deeming calculation; a portion is attributed to the sponsored non-citizen as deemed income.
schema
application.sponsors[].livesWithSponsored
When the sponsor lives with the sponsored non-citizen, a different deeming formula applies.
schema
application.sponsors[].sponsoredMemberId
FK to application.members[] identifying the household member whose benefits may be subject to sponsor income deeming.
schema
application.sponsors[].spouse.id
Identifier of the referenced person record for the sponsor's spouse.
schema
application.sponsors[].spouse.signedAffidavit
Indicates whether the sponsor's spouse co-signed the I-864 affidavit of support, which affects the scope of income deeming.
schema
application.sponsors[].spouse.ssn
Sponsor spouse's SSN required for verification of the spouse's income, which may also be deemed to the sponsored non-citizen.
schema
application.sponsors[].spouse.type
Discriminator identifying whether the sponsor's spouse is a household member or a contact-only person record in application.contacts[].
schema
application.sponsors[].ssn
Sponsor's SSN required for income and asset verification through IEVS and FDSH.
schema
application.sponsors[].type
Discriminator identifying whether the sponsor is a household member or a contact-only person record in application.contacts[].
schema
application.taxFilers[]
Tax 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.
schema
application.taxFilers[].claimingDependents
Claiming dependents affects MAGI household size and the income of dependents attributed to the tax household.
schema
application.taxFilers[].dependents[].id
Identifier of the referenced person record for the dependent; points to application.members[].id when type = member, or application.contacts[].id when type = contact.
schema
application.taxFilers[].dependents[].type
Distinguishes household members (who have a member record) from non-household dependents (who are contact-only person records in application.contacts[]).
schema
application.taxFilers[].expectedToBeClaimedByNonHouseholdMember
A household member expected to be claimed as a dependent by someone outside the household uses that person's tax household for MAGI purposes.
schema
application.taxFilers[].filingJointlyWithSpouse
Joint filing status affects MAGI household composition and income attribution for Medicaid and marketplace eligibility.
schema
application.taxFilers[].hasDomesticViolenceTaxFilingException
Domestic violence survivors may file separately from their spouse even if married, preventing their spouse's income from being included in the MAGI household.
schema
application.taxFilers[].isNonCustodialParent
Non-custodial parents who claim a child as a dependent use a different MAGI household composition rule.
schema
application.taxFilers[].memberId
Links the tax filer record to the household member. Null when the filer is a non-household member claiming a household dependent.
schema
application.taxFilers[].personClaiming.id
Identifier of the person claiming this applicant as a dependent; used to determine the applicable tax household for MAGI purposes.
schema
application.taxFilers[].personClaiming.type
Discriminator identifying whether the person claiming this applicant as a dependent is a household member or a contact-only person record in application.contacts[].
schema
application.taxFilers[].spouse.id
Identifier of the referenced person record for the spouse; used to link a non-household spouse to their contacts[] entry.
schema
application.taxFilers[].spouse.type
Discriminator identifying whether the filing spouse is a household member or a contact-only person record in application.contacts[].
schema
application.utilities.heatCoolMethod
Determines which utility allowance standard applies. Households that heat or cool with certain methods qualify for the full heating and cooling standard.
schema
application.utilities.heatCoolMethodOther
Captures non-enumerated heating or cooling methods for adapter mapping to the appropriate utility standard.
schema
application.utilities.receivesLiheap
Receipt of even one dollar of LIHEAP automatically qualifies the household for the full heating and cooling standard utility allowance.
schema
application.verifications[]
The 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.
schema
application.verifications[].category
Verification obligation category — citizenship, identity, immigration, income, or residency — determines which document types and electronic checks are applicable.
schema
application.verifications[].documentRequests[]
Outbound notices requesting documents from the applicant for this obligation. Populated when an electronic check is inconclusive and a document request is sent.
schema
application.verifications[].documentRequests[].channel
Channel through which the document request notice was sent — email, in_person, or mail.
schema
application.verifications[].documentRequests[].dueAt
Deadline by which the applicant must respond with documents. Null if no deadline was set.
schema
application.verifications[].documentRequests[].noticeId
ID of the notice in the communication domain, used to track delivery and link back to the outbound notice record.
schema
application.verifications[].documentRequests[].sentAt
When the document request notice was sent; used to calculate response deadlines and track aging obligations.
schema
application.verifications[].documentRequests[].type
Template identifier for the notice, matching the type field on the communication.notice.sent event (e.g., document_request_income_verification).
schema
application.verifications[].evidence[]
Electronic and document evidence items accumulated against this obligation. Populated as checks run and documents are received.
schema
application.verifications[].sourceId
ID of the specific record that triggered this verification obligation (e.g., a specific income or member record). Null for household-level obligations.
schema
application.verifications[].sourceType
Identifies what sourceId refers to — member or income. Required when sourceId is set; null for household-level obligations.
schema
application.verifications[].status
Current lifecycle status of the verification obligation — pending, inconclusive, satisfied, waived, or cannot_verify. Read-only; set by the rules engine.
schema
application.verifications[].verificationType
How this obligation is to be fulfilled — document (paper evidence from applicant) or electronic (automated service check).