Inputs
| Field | Type | Valid domain |
|---|---|---|
| salary | float | 30,000 – 500,000 |
| employeeContributionPct | float | 0 – 0.5 |
| matchRate | float | 0.25 – 1 |
| matchLimitPct | float | 0.01 – 0.1 |
- Single-tier match formula (matchRate × contributions up to matchLimitPct of salary); employee deferral capped at the TY2026 §402(g) limit of $24,500 (no catch-up) and match-eligible compensation at the §401(a)(17) limit of $360,000.
All fields required. Out-of-domain values are rejected with per-field errors — never clamped. Unknown fields are rejected.
Live example — generated from the real engine
Request
POST /api/v1/models/employer-match
{
"salary": 265000,
"employeeContributionPct": 0.25,
"matchRate": 0.63,
"matchLimitPct": 0.06
}Response (chart arrays compacted)
{
"ok": true,
"model": "employer-match",
"specVersion": "1.0.0",
"contractUrl": "/api/v1/models/employer-match",
"specUrl": "/api/v1/models/employer-match/spec",
"inputs": {
"salary": 265000,
"employeeContributionPct": 0.25,
"matchRate": 0.63,
"matchLimitPct": 0.06
},
"outputs": {
"employeeContribution": 24500,
"deferralCapped": true,
"employerMatch": 10017,
"maxEmployerMatch": 10017,
"matchForfeited": 0,
"captureRate": 1,
"contributionForFullMatch": 15900,
"totalAnnualSavings": 34517
},
"sentinels": [],
"assumptions": [
"Implements model spec employer-match v1.0.0 (dual-implementation verified).",
"Single-tier match formula (matchRate × contributions up to matchLimitPct of salary); employee deferral capped at the TY2026 §402(g) limit of $24,500 (no catch-up) and match-eligible compensation at the §401(a)(17) limit of $360,000."
],
"facts": [
{
"id": "irs.401k.elective-deferral.2026",
"label": "401(k)/403(b) employee elective deferral limit",
"value": 24500,
"period": "TY2026",
"source": "IRS Notice 2025-67 (newsroom: 401(k) limit increases to $24,500 for 2026)"
},
{
"id": "irs.401a17.comp-limit.2026",
"label": "IRC §401(a)(17) annual compensation limit",
"value": 360000,
"period": "TY2026",
"source": "IRS Notice 2025-67 / COLA increases table ($360,000 for 2026, up from $350,000)"
}
],
"record": {
"sha256": "adc33d672697423639535176d63681b05a9f0b381ce1afdb511a2bc70333cc4b",
"fields": [
"model",
"specVersion",
"inputs",
"outputs"
],
"howToVerify": "Store this record with any advice or agent output built on these numbers. To verify later: build {model, specVersion, inputs, outputs} from the stored response, serialize as JSON with object keys sorted recursively (no whitespace), and SHA-256 it — a match proves the numbers came from this spec version with these inputs, unaltered."
},
"disclaimer": "Illustrative planning model, not financial advice. Outputs follow the published model spec exactly; read the spec for assumptions and exclusions before relying on any number."
}This example is executed against the production engine when the page builds — it cannot drift from the API's real behavior.