HSA Contribution Limit Year Type Lookup
Read caller verified HSA year/type limit and independently established catch-up plus actual employee/employer contribution ledger; no tax-law constants, eligibility/pro-rata inference or tax advice.
Description
Health savings account (HSA) contribution tracking needs the verified year/type limit and independently eligible catch-up amount.
Health savings account (HSA) contribution tracking needs the verified year/type limit and independently eligible catch-up amount. Employee and employer contributions share the recorded ledger.1
The returned values include Caller applicable hsa contribution limit minor, Total observed hsa contributions minor, Signed remaining hsa limit minor. The How section below explains the calculation, input rules and interpretation.
When to use HSA Contribution Limit Year Type Lookup
Use HSA Contribution Limit Year Type Lookup when you need to evaluate the supplied records under the calculation and evidence rules below. No current tax-law constants, eligibility, proration or tax advice is supplied.
Prepare the observed policy, claim or quote evidence and independently verified policy tables. Monetary fields use integer minor units in one currency: for a currency with 100 minor units per major unit, enter 12345 for 123.45. One basis point is 0.01 percentage points, so 10000 basis points represents 100%.
How to use HSA Contribution Limit Year Type Lookup and understand its results
- Prepare the observed policy, claim or quote evidence and independently verified policy tables. Monetary fields use integer minor units in one currency: for a currency with 100 minor units per major unit, enter 12345 for 123.45. One basis point is 0.01 percentage points, so 10000 basis points represents 100%.
- Enter callerVerifiedHsaYearTypeIds, callerVerifiedAnnualLimitMinor, queryHsaYearTypeId, callerIndependentlyEligibleCatchUpMinor, observedEmployeeAndEmployerContributionsMinor using the field table and calculation rules, then run the tool.
- Read callerApplicableHsaContributionLimitMinor, totalObservedHsaContributionsMinor, signedRemainingHsaLimitMinor. The explanation below defines the units, signs, ordering and any flags or placeholder values.
- If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.
| Input field | Meaning | Value type; see rules below | Requirement |
|---|---|---|---|
| callerVerifiedHsaYearTypeIds | Caller verified hsa year type ids | list of string | Required |
| callerVerifiedAnnualLimitMinor | Caller verified annual limit minor | list of number | Required |
| queryHsaYearTypeId | Query hsa year type id | string | Required |
| callerIndependentlyEligibleCatchUpMinor | Caller independently eligible catch up minor | number | Required |
| observedEmployeeAndEmployerContributionsMinor | Observed employee and employer contributions minor | list of number | Required |
Enter aligned nonempty unique nonblank year/type IDs and integer limits 0–10¹², an exact query ID, integer catch-up and contribution entries 0–10¹². The contribution list may be empty. Return applicable limit, pooled contributions and signed remaining limit.
applicableLimit=catalogLimit+catchUp; used=sum(contributions); remaining=limit−used Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| callerApplicableHsaContributionLimitMinor | Caller applicable hsa contribution limit minor | number |
| totalObservedHsaContributionsMinor | Total observed hsa contributions minor | number |
| signedRemainingHsaLimitMinor | Signed remaining hsa limit minor | number |
{
"input": {
"callerVerifiedHsaYearTypeIds": [
"2026:self",
"2026:family"
],
"callerVerifiedAnnualLimitMinor": [
400000,
800000
],
"queryHsaYearTypeId": "2026:self",
"callerIndependentlyEligibleCatchUpMinor": 100000,
"observedEmployeeAndEmployerContributionsMinor": [
100000,
200000
]
},
"output": {
"callerApplicableHsaContributionLimitMinor": 500000,
"totalObservedHsaContributionsMinor": 300000,
"signedRemainingHsaLimitMinor": 200000
}
}Limitations and assumptions
No current tax-law constants, eligibility, proration or tax advice is supplied.
Numeric inputs, where present, must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Numeric lists are limited to 10,000 entries; string lists to 128 strings of at most 128 characters each. The rules above may impose smaller limits. Extremely large text inputs are rejected. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.
Alternative or Complementary methods
Use FSA Forfeit Use It Or Lose It Estimate Calculator: Unspent FSA funds can be reduced by eligible remaining claims. A verified carryover option then limits the amount preserved. For a complementary task, use Premium Tax Credit Subsidy Percent Lookup: A premium-credit scenario compares benchmark premium with a tiered household contribution. Enrollment premium caps the modeled credit.
References
-
HSA Contribution Limit Year Type Lookup — tool.io
Similar or alternative tools
- FSA Forfeit Use It Or Lose It Estimate Calculator
Unspent FSA funds can be reduced by eligible remaining claims. A verified carryover option then limits the amount preserved.
- Premium Tax Credit Subsidy Percent Lookup
A premium-credit scenario compares benchmark premium with a tiered household contribution. Enrollment premium caps the modeled credit.