Form 1040 line by line
Every line of Form 1040 for one original 2023-2025 return, numbered as that year's form numbers them. Also the MCP tool tax_compute_return_lines.
Every Form 1040 line of one original federal return, 2023-2025, in that year's numbering.
The return is the federal compute of `profile`; lines 25a-38 are as /efile-readiness figures them. One billable unit.
Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer <API key> |
| Content-Type | Yes | application/json |
| Idempotency-Key | No (recommended) | Optional. A unique key per logical request (one key per operation). Retrying with the SAME key + SAME request body replays the byte-identical first response (with header `Idempotent-Replayed: true`)…Optional. A unique key per logical request (one key per operation). Retrying with the SAME key + SAME request body replays the byte-identical first response (with header `Idempotent-Replayed: true`) and bills exactly ONCE. The SAME key with a DIFFERENT body → 409 `idempotency_key_reused`. A concurrent in-flight duplicate → 409 `idempotency_key_in_progress` (retry). Keys are scoped per account and replay for 24h. Errors (4xx/5xx) are NOT cached — a retry after an error is a fresh request. |
Request body
| Field | Description |
|---|---|
| profileFederalProfilerequired | The return, exactly as accepted by POST /tax-compute/federal. |
| paymentsobjectrequired | The same payment lines as /efile-readiness: form1099Withholding (25b), estimatedTaxPayments (26), extensionPayment (Schedule 3 line 10), appliedToNextYearEstimatedTax (36) and estimatedTaxPenalty (38). |
| paymentsAffirmedboolean | Must be true for line 27 and lines 29-38 (otherwise they come back not_computed), attesting:Must be true for line 27 and lines 29-38 (otherwise they come back not_computed), attesting: Form 1040 line 25c is only the Additional Medicare Tax withheld that the engine figures from the W-2s; form1099Withholding is the line 25b amount: federal income tax withheld on Forms 1099; estimatedTaxPayments is the line 26 amount: the estimated tax paid for the year, including any prior-year overpayment applied to it; line 27 (2025: line 27a) has no earned income credit; line 29 has no American opportunity credit; for 2025, line 30 has no refundable adoption credit; Schedule 3 has no payment or refundable credit other than the net premium tax credit the engine computes and extensionPayment, the line 10 amount paid with a request for an extension to file. |
| retirementDistributionLine"4b" | "5b" | When pensionDistributionTaxable is positive, send this or iraDistributionTaxable:When pensionDistributionTaxable is positive, send this or iraDistributionTaxable: 4b for an IRA, SEP or SIMPLE distribution (the IRA/SEP/SIMPLE box on Form 1099-R is checked), 5b for a pension or annuity. The whole amount goes on that one line. |
| iraDistributionTaxablenumber | For a return with both kinds: the part of pensionDistributionTaxable from an IRA, SEP or SIMPLE IRA. It goes on line 4b and the rest on 5b, each rounded once; if they don't add up to the return's…For a return with both kinds: the part of pensionDistributionTaxable from an IRA, SEP or SIMPLE IRA. It goes on line 4b and the rest on 5b, each rounded once; if they don't add up to the return's whole-dollar amount, the response is does_not_foot. The pension affirmations must hold for each part, and state attestations about line 5b mean all of pensionDistributionTaxable, this part included. |
Every field of profile is in the federal reference.
Example
curl https://tax-mcp.com/api/mcp/tax-compute/return-lines \
-H "Authorization: Bearer $TAX_MCP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"profile": {
"year": 2024,
"filingStatus": "single",
"canBeClaimedAsDependent": false,
"noForeignOrTerritoryExclusionAffirmed": true,
"wages": 60000,
"medicareWages": 60000,
"federalWithholding": 7000
},
"payments": {
"form1099Withholding": 300,
"estimatedTaxPayments": 500,
"extensionPayment": 0,
"appliedToNextYearEstimatedTax": 0,
"estimatedTaxPenalty": 0
},
"paymentsAffirmed": true
}'{
"computed": true,
"year": 2024,
"filingStatus": "single",
"form": "1040",
"lines": [
{ "line": "1a", "label": "W-2 wages", "status": "computed", "amount": 60000 },
{
"line": "1b",
"label": "Household employee wages",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1c",
"label": "Tip income not on line 1a",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1d",
"label": "Medicaid waiver payments",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1e",
"label": "Taxable dependent care benefits",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1f",
"label": "Employer-provided adoption benefits",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1g",
"label": "Wages from Form 8919",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1h",
"label": "Other earned income",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1i",
"label": "Nontaxable combat pay election",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1z",
"label": "Add lines 1a through 1h",
"status": "computed",
"amount": 60000
},
{
"line": "2a",
"label": "Tax-exempt interest",
"status": "assumed_zero",
"note": "not sent; nothing on the return uses it"
},
{ "line": "2b", "label": "Taxable interest", "status": "computed", "amount": 0 },
{ "line": "3a", "label": "Qualified dividends", "status": "computed", "amount": 0 },
{ "line": "3b", "label": "Ordinary dividends", "status": "computed", "amount": 0 },
{
"line": "4a",
"label": "IRA distributions",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "4b",
"label": "IRA distributions, taxable amount",
"status": "computed",
"amount": 0
},
{
"line": "5a",
"label": "Pensions and annuities",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "5b",
"label": "Pensions and annuities, taxable amount",
"status": "computed",
"amount": 0
},
{ "line": "6a", "label": "Social security benefits", "status": "computed", "amount": 0 },
{
"line": "6b",
"label": "Social security benefits, taxable amount",
"status": "computed",
"amount": 0
},
{ "line": "7", "label": "Capital gain or (loss)", "status": "computed", "amount": 0 },
{
"line": "8",
"label": "Additional income from Schedule 1, line 10",
"status": "computed",
"amount": 0
},
{ "line": "9", "label": "Total income", "status": "computed", "amount": 60000 },
{
"line": "10",
"label": "Adjustments to income from Schedule 1, line 26",
"status": "computed",
"amount": 0
},
{
"line": "11",
"label": "Adjusted gross income",
"status": "computed",
"amount": 60000
},
{
"line": "12",
"label": "Standard deduction or itemized deductions",
"status": "computed",
"amount": 14600
},
{
"line": "13",
"label": "Qualified business income deduction",
"status": "computed",
"amount": 0
},
{ "line": "14", "label": "Total deductions", "status": "computed", "amount": 14600 },
{ "line": "15", "label": "Taxable income", "status": "computed", "amount": 45400 },
{ "line": "16", "label": "Tax", "status": "computed", "amount": 5219 },
{
"line": "17",
"label": "Amount from Schedule 2, line 3",
"status": "computed",
"amount": 0
},
{ "line": "18", "label": "Add lines 16 and 17", "status": "computed", "amount": 5219 },
{
"line": "19",
"label": "Child tax credit or credit for other dependents",
"status": "computed",
"amount": 0
},
{
"line": "20",
"label": "Amount from Schedule 3, line 8",
"status": "computed",
"amount": 0
},
{ "line": "21", "label": "Add lines 19 and 20", "status": "computed", "amount": 0 },
{
"line": "22",
"label": "Subtract line 21 from line 18",
"status": "computed",
"amount": 5219
},
{
"line": "23",
"label": "Other taxes from Schedule 2, line 21",
"status": "computed",
"amount": 0
},
{ "line": "24", "label": "Total tax", "status": "computed", "amount": 5219 },
{
"line": "25a",
"label": "Federal income tax withheld from Form(s) W-2",
"status": "computed",
"amount": 7000
},
{
"line": "25b",
"label": "Federal income tax withheld from Form(s) 1099",
"status": "computed",
"amount": 300
},
{
"line": "25c",
"label": "Federal income tax withheld from other forms",
"status": "computed",
"amount": 0
},
{
"line": "25d",
"label": "Add lines 25a through 25c",
"status": "computed",
"amount": 7300
},
{
"line": "26",
"label": "Estimated tax payments and amount applied from the prior year",
"status": "computed",
"amount": 500
},
{
"line": "27",
"label": "Earned income credit",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "28",
"label": "Additional child tax credit",
"status": "computed",
"amount": 0
},
{
"line": "29",
"label": "American opportunity credit",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "31",
"label": "Amount from Schedule 3, line 15",
"status": "computed",
"amount": 0
},
{
"line": "32",
"label": "Total other payments and refundable credits",
"status": "computed",
"amount": 0
},
{ "line": "33", "label": "Total payments", "status": "computed", "amount": 7800 },
{ "line": "34", "label": "Amount overpaid", "status": "computed", "amount": 2581 },
{
"line": "35a",
"label": "Amount refunded to you",
"status": "computed",
"amount": 2581
},
{
"line": "36",
"label": "Amount applied to next year's estimated tax",
"status": "computed",
"amount": 0
},
{ "line": "37", "label": "Amount you owe", "status": "computed", "amount": 0 },
{ "line": "38", "label": "Estimated tax penalty", "status": "computed", "amount": 0 }
],
"schedules": {},
"flags": [],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": {
"engine": "deterministic",
"jurisdiction": "return-lines",
"tax_year": 2024
},
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "<computation-support notice — see full response>"
}
}Full response, including line derivations
{
"computed": true,
"year": 2024,
"filingStatus": "single",
"form": "1040",
"lines": [
{ "line": "1a", "label": "W-2 wages", "status": "computed", "amount": 60000 },
{
"line": "1b",
"label": "Household employee wages",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1c",
"label": "Tip income not on line 1a",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1d",
"label": "Medicaid waiver payments",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1e",
"label": "Taxable dependent care benefits",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1f",
"label": "Employer-provided adoption benefits",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1g",
"label": "Wages from Form 8919",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1h",
"label": "Other earned income",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1i",
"label": "Nontaxable combat pay election",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1z",
"label": "Add lines 1a through 1h",
"status": "computed",
"amount": 60000
},
{
"line": "2a",
"label": "Tax-exempt interest",
"status": "assumed_zero",
"note": "not sent; nothing on the return uses it"
},
{ "line": "2b", "label": "Taxable interest", "status": "computed", "amount": 0 },
{ "line": "3a", "label": "Qualified dividends", "status": "computed", "amount": 0 },
{ "line": "3b", "label": "Ordinary dividends", "status": "computed", "amount": 0 },
{
"line": "4a",
"label": "IRA distributions",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "4b",
"label": "IRA distributions, taxable amount",
"status": "computed",
"amount": 0
},
{
"line": "5a",
"label": "Pensions and annuities",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "5b",
"label": "Pensions and annuities, taxable amount",
"status": "computed",
"amount": 0
},
{ "line": "6a", "label": "Social security benefits", "status": "computed", "amount": 0 },
{
"line": "6b",
"label": "Social security benefits, taxable amount",
"status": "computed",
"amount": 0
},
{ "line": "7", "label": "Capital gain or (loss)", "status": "computed", "amount": 0 },
{
"line": "8",
"label": "Additional income from Schedule 1, line 10",
"status": "computed",
"amount": 0
},
{ "line": "9", "label": "Total income", "status": "computed", "amount": 60000 },
{
"line": "10",
"label": "Adjustments to income from Schedule 1, line 26",
"status": "computed",
"amount": 0
},
{
"line": "11",
"label": "Adjusted gross income",
"status": "computed",
"amount": 60000
},
{
"line": "12",
"label": "Standard deduction or itemized deductions",
"status": "computed",
"amount": 14600
},
{
"line": "13",
"label": "Qualified business income deduction",
"status": "computed",
"amount": 0
},
{ "line": "14", "label": "Total deductions", "status": "computed", "amount": 14600 },
{ "line": "15", "label": "Taxable income", "status": "computed", "amount": 45400 },
{ "line": "16", "label": "Tax", "status": "computed", "amount": 5219 },
{
"line": "17",
"label": "Amount from Schedule 2, line 3",
"status": "computed",
"amount": 0
},
{ "line": "18", "label": "Add lines 16 and 17", "status": "computed", "amount": 5219 },
{
"line": "19",
"label": "Child tax credit or credit for other dependents",
"status": "computed",
"amount": 0
},
{
"line": "20",
"label": "Amount from Schedule 3, line 8",
"status": "computed",
"amount": 0
},
{ "line": "21", "label": "Add lines 19 and 20", "status": "computed", "amount": 0 },
{
"line": "22",
"label": "Subtract line 21 from line 18",
"status": "computed",
"amount": 5219
},
{
"line": "23",
"label": "Other taxes from Schedule 2, line 21",
"status": "computed",
"amount": 0
},
{ "line": "24", "label": "Total tax", "status": "computed", "amount": 5219 },
{
"line": "25a",
"label": "Federal income tax withheld from Form(s) W-2",
"status": "computed",
"amount": 7000
},
{
"line": "25b",
"label": "Federal income tax withheld from Form(s) 1099",
"status": "computed",
"amount": 300
},
{
"line": "25c",
"label": "Federal income tax withheld from other forms",
"status": "computed",
"amount": 0
},
{
"line": "25d",
"label": "Add lines 25a through 25c",
"status": "computed",
"amount": 7300
},
{
"line": "26",
"label": "Estimated tax payments and amount applied from the prior year",
"status": "computed",
"amount": 500
},
{
"line": "27",
"label": "Earned income credit",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "28",
"label": "Additional child tax credit",
"status": "computed",
"amount": 0
},
{
"line": "29",
"label": "American opportunity credit",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "31",
"label": "Amount from Schedule 3, line 15",
"status": "computed",
"amount": 0
},
{
"line": "32",
"label": "Total other payments and refundable credits",
"status": "computed",
"amount": 0
},
{ "line": "33", "label": "Total payments", "status": "computed", "amount": 7800 },
{ "line": "34", "label": "Amount overpaid", "status": "computed", "amount": 2581 },
{
"line": "35a",
"label": "Amount refunded to you",
"status": "computed",
"amount": 2581
},
{
"line": "36",
"label": "Amount applied to next year's estimated tax",
"status": "computed",
"amount": 0
},
{ "line": "37", "label": "Amount you owe", "status": "computed", "amount": 0 },
{ "line": "38", "label": "Estimated tax penalty", "status": "computed", "amount": 0 }
],
"schedules": {},
"flags": [],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": {
"engine": "deterministic",
"jurisdiction": "return-lines",
"tax_year": 2024
},
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "Computation support only. Not tax, legal, accounting, or financial advice. Customer is responsible for review, filing positions, and use only within the documented supported envelope."
}
}With Schedule C income and interest above the net investment income tax threshold, schedules carries Schedules 1, 2 and 3 line by line. Each total equals the Form 1040 line it carries to.
curl https://tax-mcp.com/api/mcp/tax-compute/return-lines \
-H "Authorization: Bearer $TAX_MCP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"profile": {
"year": 2024,
"filingStatus": "married_filing_jointly",
"canBeClaimedAsDependent": false,
"noForeignOrTerritoryExclusionAffirmed": true,
"scheduleCIncome": 100000,
"scheduleCIsSingleSolePropFinalNetAffirmed": true,
"scheduleCNoAmtAdjustmentAffirmed": true,
"scheduleCQbiEligible": true,
"taxableInterest": 200000,
"estateTrustK1NoAmtAdjustmentAffirmed": true
},
"payments": {
"form1099Withholding": 0,
"estimatedTaxPayments": 0,
"extensionPayment": 1000,
"appliedToNextYearEstimatedTax": 0,
"estimatedTaxPenalty": 0
},
"paymentsAffirmed": true
}'{
"computed": true,
"year": 2024,
"filingStatus": "married_filing_jointly",
"form": "1040",
"lines": [
{ "line": "1a", "label": "W-2 wages", "status": "computed", "amount": 0 },
{
"line": "1b",
"label": "Household employee wages",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1c",
"label": "Tip income not on line 1a",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1d",
"label": "Medicaid waiver payments",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1e",
"label": "Taxable dependent care benefits",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1f",
"label": "Employer-provided adoption benefits",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1g",
"label": "Wages from Form 8919",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1h",
"label": "Other earned income",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1i",
"label": "Nontaxable combat pay election",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{ "line": "1z", "label": "Add lines 1a through 1h", "status": "computed", "amount": 0 },
{
"line": "2a",
"label": "Tax-exempt interest",
"status": "assumed_zero",
"note": "not sent; nothing on the return uses it"
},
{ "line": "2b", "label": "Taxable interest", "status": "computed", "amount": 200000 },
{ "line": "3a", "label": "Qualified dividends", "status": "computed", "amount": 0 },
{ "line": "3b", "label": "Ordinary dividends", "status": "computed", "amount": 0 },
{
"line": "4a",
"label": "IRA distributions",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "4b",
"label": "IRA distributions, taxable amount",
"status": "computed",
"amount": 0
},
{
"line": "5a",
"label": "Pensions and annuities",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "5b",
"label": "Pensions and annuities, taxable amount",
"status": "computed",
"amount": 0
},
{ "line": "6a", "label": "Social security benefits", "status": "computed", "amount": 0 },
{
"line": "6b",
"label": "Social security benefits, taxable amount",
"status": "computed",
"amount": 0
},
{ "line": "7", "label": "Capital gain or (loss)", "status": "computed", "amount": 0 },
{
"line": "8",
"label": "Additional income from Schedule 1, line 10",
"status": "computed",
"amount": 100000
},
{ "line": "9", "label": "Total income", "status": "computed", "amount": 300000 },
{
"line": "10",
"label": "Adjustments to income from Schedule 1, line 26",
"status": "computed",
"amount": 7065
},
{
"line": "11",
"label": "Adjusted gross income",
"status": "computed",
"amount": 292935
},
{
"line": "12",
"label": "Standard deduction or itemized deductions",
"status": "computed",
"amount": 29200
},
{
"line": "13",
"label": "Qualified business income deduction",
"status": "computed",
"amount": 18587
},
{ "line": "14", "label": "Total deductions", "status": "computed", "amount": 47787 },
{ "line": "15", "label": "Taxable income", "status": "computed", "amount": 245148 },
{ "line": "16", "label": "Tax", "status": "computed", "amount": 44921 },
{
"line": "17",
"label": "Amount from Schedule 2, line 3",
"status": "computed",
"amount": 0
},
{ "line": "18", "label": "Add lines 16 and 17", "status": "computed", "amount": 44921 },
{
"line": "19",
"label": "Child tax credit or credit for other dependents",
"status": "computed",
"amount": 0
},
{
"line": "20",
"label": "Amount from Schedule 3, line 8",
"status": "computed",
"amount": 0
},
{ "line": "21", "label": "Add lines 19 and 20", "status": "computed", "amount": 0 },
{
"line": "22",
"label": "Subtract line 21 from line 18",
"status": "computed",
"amount": 44921
},
{
"line": "23",
"label": "Other taxes from Schedule 2, line 21",
"status": "computed",
"amount": 15761
},
{ "line": "24", "label": "Total tax", "status": "computed", "amount": 60682 },
{
"line": "25a",
"label": "Federal income tax withheld from Form(s) W-2",
"status": "computed",
"amount": 0
},
{
"line": "25b",
"label": "Federal income tax withheld from Form(s) 1099",
"status": "computed",
"amount": 0
},
{
"line": "25c",
"label": "Federal income tax withheld from other forms",
"status": "computed",
"amount": 0
},
{
"line": "25d",
"label": "Add lines 25a through 25c",
"status": "computed",
"amount": 0
},
{
"line": "26",
"label": "Estimated tax payments and amount applied from the prior year",
"status": "computed",
"amount": 0
},
{
"line": "27",
"label": "Earned income credit",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "28",
"label": "Additional child tax credit",
"status": "computed",
"amount": 0
},
{
"line": "29",
"label": "American opportunity credit",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "31",
"label": "Amount from Schedule 3, line 15",
"status": "computed",
"amount": 1000
},
{
"line": "32",
"label": "Total other payments and refundable credits",
"status": "computed",
"amount": 1000
},
{ "line": "33", "label": "Total payments", "status": "computed", "amount": 1000 },
{ "line": "34", "label": "Amount overpaid", "status": "computed", "amount": 0 },
{ "line": "35a", "label": "Amount refunded to you", "status": "computed", "amount": 0 },
{
"line": "36",
"label": "Amount applied to next year's estimated tax",
"status": "computed",
"amount": 0
},
{ "line": "37", "label": "Amount you owe", "status": "computed", "amount": 59682 },
{ "line": "38", "label": "Estimated tax penalty", "status": "computed", "amount": 0 }
],
"schedules": {
"1": [
{
"line": "1",
"label": "Taxable refunds, credits, or offsets of state and local income taxes",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "2a",
"label": "Alimony received",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "3",
"label": "Business income or (loss)",
"status": "computed",
"amount": 100000
},
{
"line": "4",
"label": "Other gains or (losses)",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "5",
"label": "Rental real estate, royalties, partnerships, S corporations, trusts, etc.",
"status": "computed",
"amount": 0
},
{
"line": "6",
"label": "Farm income or (loss)",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "7",
"label": "Unemployment compensation",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{ "line": "8b", "label": "Gambling", "status": "computed", "amount": 0 },
{
"line": "9",
"label": "Total other income",
"status": "computed",
"amount": 0,
"note": "lines 8a and 8c-8z have no engine input; 0"
},
{ "line": "10", "label": "Additional income", "status": "computed", "amount": 100000 },
{
"line": "11",
"label": "Educator expenses",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "12",
"label": "Certain business expenses of reservists, performing artists, and fee-basis government officials",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "13",
"label": "Health savings account deduction",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "14",
"label": "Moving expenses for members of the Armed Forces",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "15",
"label": "Deductible part of self-employment tax",
"status": "computed",
"amount": 7065
},
{
"line": "16",
"label": "Self-employed SEP, SIMPLE, and qualified plans",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "17",
"label": "Self-employed health insurance deduction",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "18",
"label": "Penalty on early withdrawal of savings",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "19a",
"label": "Alimony paid",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "20",
"label": "IRA deduction",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "21",
"label": "Student loan interest deduction",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "23",
"label": "Archer MSA deduction",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "25",
"label": "Total other adjustments",
"status": "computed",
"amount": 0,
"note": "lines 24a-24z have no engine input; 0"
},
{
"line": "26",
"label": "Adjustments to income",
"status": "computed",
"amount": 7065
}
],
"2": [
{
"line": "1a",
"label": "Excess advance premium tax credit repayment",
"status": "computed",
"amount": 0
},
{
"line": "1z",
"label": "Add lines 1a through 1y",
"status": "computed",
"amount": 0,
"note": "lines 1b-1y have no engine input; 0"
},
{ "line": "2", "label": "Alternative minimum tax", "status": "computed", "amount": 0 },
{ "line": "3", "label": "Add lines 1z and 2", "status": "computed", "amount": 0 },
{ "line": "4", "label": "Self-employment tax", "status": "computed", "amount": 14129 },
{
"line": "5",
"label": "Social security and Medicare tax on unreported tip income",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "6",
"label": "Uncollected social security and Medicare tax on wages",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "7",
"label": "Total additional social security and Medicare tax",
"status": "computed",
"amount": 0
},
{
"line": "8",
"label": "Additional tax on IRAs or other tax-favored accounts",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "9",
"label": "Household employment taxes",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "10",
"label": "Repayment of first-time homebuyer credit",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "11",
"label": "Additional Medicare Tax",
"status": "computed",
"amount": 0
},
{
"line": "12",
"label": "Net investment income tax",
"status": "computed",
"amount": 1632
},
{
"line": "13",
"label": "Uncollected social security and Medicare or RRTA tax on tips or group-term life insurance",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "14",
"label": "Interest on tax due on installment income from the sale of certain residential lots and timeshares",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "15",
"label": "Interest on the deferred tax on gain from certain installment sales with a sales price over $150,000",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "16",
"label": "Recapture of low-income housing credit",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "18",
"label": "Total additional taxes",
"status": "computed",
"amount": 0,
"note": "lines 17a-17z have no engine input; 0"
},
{
"line": "19",
"label": "Recapture of net EPE from Form 4255",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{ "line": "21", "label": "Total other taxes", "status": "computed", "amount": 15761 }
],
"3": [
{ "line": "1", "label": "Foreign tax credit", "status": "computed", "amount": 0 },
{
"line": "2",
"label": "Credit for child and dependent care expenses",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "3",
"label": "Education credits",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "4",
"label": "Retirement savings contributions credit",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "5a",
"label": "Residential clean energy credit",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "5b",
"label": "Energy efficient home improvement credit",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "7",
"label": "Total other nonrefundable credits",
"status": "computed",
"amount": 0,
"note": "lines 6a-6z have no engine input; 0"
},
{ "line": "8", "label": "Nonrefundable credits", "status": "computed", "amount": 0 },
{ "line": "9", "label": "Net premium tax credit", "status": "computed", "amount": 0 },
{
"line": "10",
"label": "Amount paid with request for extension to file",
"status": "computed",
"amount": 1000
},
{
"line": "11",
"label": "Excess social security and tier 1 RRTA tax withheld",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "12",
"label": "Credit for federal tax on fuels",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "14",
"label": "Total other payments or refundable credits",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "15",
"label": "Other payments and refundable credits",
"status": "computed",
"amount": 1000
}
]
},
"flags": [
"SCHEDULE-C-SE-COMPUTED ($100,000 net) → self-employment tax $14,129 (Schedule SE: net×0.9235=$92,350; OASDI $11,451 at 12.4% to the $168,600 wage base; Medicare $2,678 at 2.9%) → Schedule 2. The §164(f) one-half-SE-tax deduction $7,065 reduces AGI (Schedule 1 line 15). The net is ORDINARY income → AGI (Schedule 1 line 3 → 1040 line 8), NOT in the §1411 NIIT base. Assumes (affirmed): FINAL Schedule C line-31 net of ONE sole proprietor, no depreciation / §179 / SE-health-insurance / home-office, not farm/clergy/statutory, not two spouses' combined SE. §199A QBI OPT-IN: the 20% QBI deduction is computed on (net − half-SE = $92,935) IF taxable income is at/below the 2024 §199A threshold (else declines to Form 8995-A); assumes no SE retirement/health/other QBI-reducer beyond half-SE."
],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": {
"engine": "deterministic",
"jurisdiction": "return-lines",
"tax_year": 2024
},
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "<computation-support notice — see full response>"
}
}Full response, including line derivations
{
"computed": true,
"year": 2024,
"filingStatus": "married_filing_jointly",
"form": "1040",
"lines": [
{ "line": "1a", "label": "W-2 wages", "status": "computed", "amount": 0 },
{
"line": "1b",
"label": "Household employee wages",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1c",
"label": "Tip income not on line 1a",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1d",
"label": "Medicaid waiver payments",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1e",
"label": "Taxable dependent care benefits",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1f",
"label": "Employer-provided adoption benefits",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1g",
"label": "Wages from Form 8919",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1h",
"label": "Other earned income",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "1i",
"label": "Nontaxable combat pay election",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{ "line": "1z", "label": "Add lines 1a through 1h", "status": "computed", "amount": 0 },
{
"line": "2a",
"label": "Tax-exempt interest",
"status": "assumed_zero",
"note": "not sent; nothing on the return uses it"
},
{ "line": "2b", "label": "Taxable interest", "status": "computed", "amount": 200000 },
{ "line": "3a", "label": "Qualified dividends", "status": "computed", "amount": 0 },
{ "line": "3b", "label": "Ordinary dividends", "status": "computed", "amount": 0 },
{
"line": "4a",
"label": "IRA distributions",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "4b",
"label": "IRA distributions, taxable amount",
"status": "computed",
"amount": 0
},
{
"line": "5a",
"label": "Pensions and annuities",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "5b",
"label": "Pensions and annuities, taxable amount",
"status": "computed",
"amount": 0
},
{ "line": "6a", "label": "Social security benefits", "status": "computed", "amount": 0 },
{
"line": "6b",
"label": "Social security benefits, taxable amount",
"status": "computed",
"amount": 0
},
{ "line": "7", "label": "Capital gain or (loss)", "status": "computed", "amount": 0 },
{
"line": "8",
"label": "Additional income from Schedule 1, line 10",
"status": "computed",
"amount": 100000
},
{ "line": "9", "label": "Total income", "status": "computed", "amount": 300000 },
{
"line": "10",
"label": "Adjustments to income from Schedule 1, line 26",
"status": "computed",
"amount": 7065
},
{
"line": "11",
"label": "Adjusted gross income",
"status": "computed",
"amount": 292935
},
{
"line": "12",
"label": "Standard deduction or itemized deductions",
"status": "computed",
"amount": 29200
},
{
"line": "13",
"label": "Qualified business income deduction",
"status": "computed",
"amount": 18587
},
{ "line": "14", "label": "Total deductions", "status": "computed", "amount": 47787 },
{ "line": "15", "label": "Taxable income", "status": "computed", "amount": 245148 },
{ "line": "16", "label": "Tax", "status": "computed", "amount": 44921 },
{
"line": "17",
"label": "Amount from Schedule 2, line 3",
"status": "computed",
"amount": 0
},
{ "line": "18", "label": "Add lines 16 and 17", "status": "computed", "amount": 44921 },
{
"line": "19",
"label": "Child tax credit or credit for other dependents",
"status": "computed",
"amount": 0
},
{
"line": "20",
"label": "Amount from Schedule 3, line 8",
"status": "computed",
"amount": 0
},
{ "line": "21", "label": "Add lines 19 and 20", "status": "computed", "amount": 0 },
{
"line": "22",
"label": "Subtract line 21 from line 18",
"status": "computed",
"amount": 44921
},
{
"line": "23",
"label": "Other taxes from Schedule 2, line 21",
"status": "computed",
"amount": 15761
},
{ "line": "24", "label": "Total tax", "status": "computed", "amount": 60682 },
{
"line": "25a",
"label": "Federal income tax withheld from Form(s) W-2",
"status": "computed",
"amount": 0
},
{
"line": "25b",
"label": "Federal income tax withheld from Form(s) 1099",
"status": "computed",
"amount": 0
},
{
"line": "25c",
"label": "Federal income tax withheld from other forms",
"status": "computed",
"amount": 0
},
{
"line": "25d",
"label": "Add lines 25a through 25c",
"status": "computed",
"amount": 0
},
{
"line": "26",
"label": "Estimated tax payments and amount applied from the prior year",
"status": "computed",
"amount": 0
},
{
"line": "27",
"label": "Earned income credit",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "28",
"label": "Additional child tax credit",
"status": "computed",
"amount": 0
},
{
"line": "29",
"label": "American opportunity credit",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "31",
"label": "Amount from Schedule 3, line 15",
"status": "computed",
"amount": 1000
},
{
"line": "32",
"label": "Total other payments and refundable credits",
"status": "computed",
"amount": 1000
},
{ "line": "33", "label": "Total payments", "status": "computed", "amount": 1000 },
{ "line": "34", "label": "Amount overpaid", "status": "computed", "amount": 0 },
{ "line": "35a", "label": "Amount refunded to you", "status": "computed", "amount": 0 },
{
"line": "36",
"label": "Amount applied to next year's estimated tax",
"status": "computed",
"amount": 0
},
{ "line": "37", "label": "Amount you owe", "status": "computed", "amount": 59682 },
{ "line": "38", "label": "Estimated tax penalty", "status": "computed", "amount": 0 }
],
"schedules": {
"1": [
{
"line": "1",
"label": "Taxable refunds, credits, or offsets of state and local income taxes",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "2a",
"label": "Alimony received",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "3",
"label": "Business income or (loss)",
"status": "computed",
"amount": 100000
},
{
"line": "4",
"label": "Other gains or (losses)",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "5",
"label": "Rental real estate, royalties, partnerships, S corporations, trusts, etc.",
"status": "computed",
"amount": 0
},
{
"line": "6",
"label": "Farm income or (loss)",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "7",
"label": "Unemployment compensation",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{ "line": "8b", "label": "Gambling", "status": "computed", "amount": 0 },
{
"line": "9",
"label": "Total other income",
"status": "computed",
"amount": 0,
"note": "lines 8a and 8c-8z have no engine input; 0"
},
{ "line": "10", "label": "Additional income", "status": "computed", "amount": 100000 },
{
"line": "11",
"label": "Educator expenses",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "12",
"label": "Certain business expenses of reservists, performing artists, and fee-basis government officials",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "13",
"label": "Health savings account deduction",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "14",
"label": "Moving expenses for members of the Armed Forces",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "15",
"label": "Deductible part of self-employment tax",
"status": "computed",
"amount": 7065
},
{
"line": "16",
"label": "Self-employed SEP, SIMPLE, and qualified plans",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "17",
"label": "Self-employed health insurance deduction",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "18",
"label": "Penalty on early withdrawal of savings",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "19a",
"label": "Alimony paid",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "20",
"label": "IRA deduction",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "21",
"label": "Student loan interest deduction",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "23",
"label": "Archer MSA deduction",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "25",
"label": "Total other adjustments",
"status": "computed",
"amount": 0,
"note": "lines 24a-24z have no engine input; 0"
},
{
"line": "26",
"label": "Adjustments to income",
"status": "computed",
"amount": 7065
}
],
"2": [
{
"line": "1a",
"label": "Excess advance premium tax credit repayment",
"status": "computed",
"amount": 0
},
{
"line": "1z",
"label": "Add lines 1a through 1y",
"status": "computed",
"amount": 0,
"note": "lines 1b-1y have no engine input; 0"
},
{ "line": "2", "label": "Alternative minimum tax", "status": "computed", "amount": 0 },
{ "line": "3", "label": "Add lines 1z and 2", "status": "computed", "amount": 0 },
{ "line": "4", "label": "Self-employment tax", "status": "computed", "amount": 14129 },
{
"line": "5",
"label": "Social security and Medicare tax on unreported tip income",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "6",
"label": "Uncollected social security and Medicare tax on wages",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "7",
"label": "Total additional social security and Medicare tax",
"status": "computed",
"amount": 0
},
{
"line": "8",
"label": "Additional tax on IRAs or other tax-favored accounts",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "9",
"label": "Household employment taxes",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "10",
"label": "Repayment of first-time homebuyer credit",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "11",
"label": "Additional Medicare Tax",
"status": "computed",
"amount": 0
},
{
"line": "12",
"label": "Net investment income tax",
"status": "computed",
"amount": 1632
},
{
"line": "13",
"label": "Uncollected social security and Medicare or RRTA tax on tips or group-term life insurance",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "14",
"label": "Interest on tax due on installment income from the sale of certain residential lots and timeshares",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "15",
"label": "Interest on the deferred tax on gain from certain installment sales with a sales price over $150,000",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "16",
"label": "Recapture of low-income housing credit",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "18",
"label": "Total additional taxes",
"status": "computed",
"amount": 0,
"note": "lines 17a-17z have no engine input; 0"
},
{
"line": "19",
"label": "Recapture of net EPE from Form 4255",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{ "line": "21", "label": "Total other taxes", "status": "computed", "amount": 15761 }
],
"3": [
{ "line": "1", "label": "Foreign tax credit", "status": "computed", "amount": 0 },
{
"line": "2",
"label": "Credit for child and dependent care expenses",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "3",
"label": "Education credits",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "4",
"label": "Retirement savings contributions credit",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "5a",
"label": "Residential clean energy credit",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "5b",
"label": "Energy efficient home improvement credit",
"status": "assumed_zero",
"note": "no engine input; the totals treat it as 0"
},
{
"line": "7",
"label": "Total other nonrefundable credits",
"status": "computed",
"amount": 0,
"note": "lines 6a-6z have no engine input; 0"
},
{ "line": "8", "label": "Nonrefundable credits", "status": "computed", "amount": 0 },
{ "line": "9", "label": "Net premium tax credit", "status": "computed", "amount": 0 },
{
"line": "10",
"label": "Amount paid with request for extension to file",
"status": "computed",
"amount": 1000
},
{
"line": "11",
"label": "Excess social security and tier 1 RRTA tax withheld",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "12",
"label": "Credit for federal tax on fuels",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "14",
"label": "Total other payments or refundable credits",
"status": "assumed_zero",
"note": "0 under paymentsAffirmed"
},
{
"line": "15",
"label": "Other payments and refundable credits",
"status": "computed",
"amount": 1000
}
]
},
"flags": [
"SCHEDULE-C-SE-COMPUTED ($100,000 net) → self-employment tax $14,129 (Schedule SE: net×0.9235=$92,350; OASDI $11,451 at 12.4% to the $168,600 wage base; Medicare $2,678 at 2.9%) → Schedule 2. The §164(f) one-half-SE-tax deduction $7,065 reduces AGI (Schedule 1 line 15). The net is ORDINARY income → AGI (Schedule 1 line 3 → 1040 line 8), NOT in the §1411 NIIT base. Assumes (affirmed): FINAL Schedule C line-31 net of ONE sole proprietor, no depreciation / §179 / SE-health-insurance / home-office, not farm/clergy/statutory, not two spouses' combined SE. §199A QBI OPT-IN: the 20% QBI deduction is computed on (net − half-SE = $92,935) IF taxable income is at/below the 2024 §199A threshold (else declines to Form 8995-A); assumes no SE retirement/health/other QBI-reducer beyond half-SE."
],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": {
"engine": "deterministic",
"jurisdiction": "return-lines",
"tax_year": 2024
},
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "Computation support only. Not tax, legal, accounting, or financial advice. Customer is responsible for review, filing positions, and use only within the documented supported envelope."
}
}With a qualifying child or other dependent, schedules["8812"]carries Schedule 8812 as the year's form numbers it, stopping where the form says to stop. Lines 4, 6 and 16b's count of children (16b_count) are numbers of people, not dollars, and carry unit: "count".
With capital gains or losses, schedules.Dcarries Schedule D's totals: the carryovers (lines 6 and 14, negative), net short- and long-term gain or loss (7, 15), line 16, the capped loss (21) and Part III. The Form 8949 detail lines are not_computed, because the engine keeps only the net totals, and their note names what went into them. Part III's Yes/No questions have status: "answered" and an answer of "yes" or "no".
Responses
| Status | Meaning |
|---|---|
| 200 | { computed, year, filingStatus, form:{ computed, year, filingStatus, form: "1040", lines[{line, label, status, amount | note | answer, unit?}], schedules{"1"|"2"|"3"|"D"|"8812": lines}, flags } or a decline { computed: false, code, reason, returnDecline }. status is computed, assumed_zero (no engine input; totals treat it as 0), blank (the form leaves it empty), not_computed (needs paymentsAffirmed or detail it lacks) or answered (Yes/No). Decline codes: return_declined, engine_line_mismatch, retirement_line_unknown, applied_exceeds_overpayment, does_not_foot. |
| 400 | Invalid body / JSON / failed validation |
| 401 | Missing / unknown / revoked key (no enumeration) |
| 403 | Account suspended — contact billing (distinct from 401: the key is valid) |
| 409 | Idempotency-Key reused with a different body (`idempotency_key_reused`), or a concurrent in-flight duplicate (`idempotency_key_in_progress`). Retry; NOT billed. |
| 429 | Monthly quota exhausted (account-wide;Monthly quota exhausted (account-wide; `quota_exceeded`, next_action `upgrade_plan_or_wait_next_period`, retry_safe false) or per-minute rate exceeded (`rate_limit_exceeded`, next_action `retry_after_backoff`, retry_safe true). Not billed. |
| 500 | Sanitized server error computing the return |
| 503 | Metering outage — fail-closed (the call is NOT silently served free) |
Each line has a status. computed lines carry an amount. An assumed_zeroline is one the engine has no input for, and every total on the form treats it as 0: if it isn't 0 on the real return, change the profile and call again rather than editing the line. A blank line is one the instructions leave empty, such as 4a or 5a when the distribution is fully taxable. Lines 27 and 29-38 are not_computed without paymentsAffirmed. Before answering, the engine re-checks every "Add" and "Subtract" instruction on the form and its schedules against the whole-dollar lines, and each schedule total against the Form 1040 line it carries to; a mismatch declines with does_not_foot.
Roadmap status for this page
Generated from the roadmap (updated 2026-10-30). Shipped & certified means live and independently checked against primary tax sources; certifying means live, with those checks still in progress.
| Capability | Status |
|---|---|
| Form 1040 line by line, 2023-2025Form 1040 lines 1a-38 of an original 2023-2025 return in that year's numbering; the totals foot, and lines with no input are marked. |