Docs · Model reference
eldercare
Verified · spec v1.0.1Inputs
| Field | Type | Valid domain |
|---|---|---|
| parentAge | int | 60 – 90 |
| careStartAge | int | 60 – 100 |
| careDurationYears | int | 1 – 15 |
| careType | choice | in-home-basic | in-home-full | assisted-living | memory-care | nursing-home |
| parentAssets | float | 0 – 1,000,000 |
| yourCurrentSavings | float | 0 – 2,000,000 |
| yourMonthlySavings | float | 0 – 10,000 |
| annualReturnRate | float | 3 – 12 |
- careStartAge must be at least parentAge
- annualReturnRate is in PERCENT points (e.g. 7 = 7%), not a decimal
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/eldercare
{
"parentAge": 75,
"careStartAge": 80,
"careDurationYears": 8,
"careType": "in-home-basic",
"parentAssets": 500000,
"yourCurrentSavings": 1000000,
"yourMonthlySavings": 5000,
"annualReturnRate": 7.5
}Response (chart arrays compacted)
{
"ok": true,
"model": "eldercare",
"specVersion": "1.0.1",
"contractUrl": "/api/v1/models/eldercare",
"specUrl": "/api/v1/models/eldercare/spec",
"inputs": {
"parentAge": 75,
"careStartAge": 80,
"careDurationYears": 8,
"careType": "in-home-basic",
"parentAssets": 500000,
"yourCurrentSavings": 1000000,
"yourMonthlySavings": 5000,
"annualReturnRate": 7.5
},
"outputs": {
"monthlyCareTypeCost": 2500,
"annualCareTypeCost": 30000,
"totalProjectedCareCost": 240000,
"parentAssetsRunoutAge": 88,
"yourShareOfCost": 0,
"yourMonthlyBurden": 0,
"retirementSavingsImpact": 0,
"retirementSavingsWithoutCare": 14958919.340144027,
"retirementSavingsWithCare": 14958919.340144027,
"fireImpactYears": 0,
"yearlyData": [
{
"year": 2026,
"parentAssets": 717814.6630859374,
"yourSavings": 1135000,
"cumulativeCost": 0
},
{
"year": 2027,
"parentAssets": 717814.6630859374,
"yourSavings": 1280125,
"cumulativeCost": 0
},
"… 28 more"
]
},
"sentinels": [],
"assumptions": [
"Implements model spec eldercare v1.0.1 (dual-implementation verified).",
"careStartAge must be at least parentAge",
"annualReturnRate is in PERCENT points (e.g. 7 = 7%), not a decimal"
],
"facts": [],
"record": {
"sha256": "8c69a449d3b685b188fb09660cc545b777afb8e8c96ea89e12b4a257c88efb03",
"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.