API reference

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.

POSThttps://tax-mcp.com/api/mcp/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

HeaderRequiredDescription
AuthorizationYesBearer <API key>
Content-TypeYesapplication/json
Idempotency-KeyNo (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

FieldDescription
profileFederalProfilerequiredThe return, exactly as accepted by POST /tax-compute/federal.
paymentsobjectrequiredThe 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

Request
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
  }'
Response 200 · COMPUTED
{
  "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.

Request
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
  }'
Response 200 · COMPUTED
{
  "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

StatusMeaning
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.

400Invalid body / JSON / failed validation
401Missing / unknown / revoked key (no enumeration)
403Account suspended — contact billing (distinct from 401: the key is valid)
409Idempotency-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.

500Sanitized server error computing the return
503Metering 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.

Lifecycle — projection, estimates, amendments
CapabilityStatus
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.◐ certifying