Terminal Tax

Checks the taxpayer's completed draft packet for a federal return and, when it passes, holds it as an unsigned draft and returns the link to the filing page; otherwise returns a list of problems to correct. This call files nothing and sends nothing to the IRS: the taxpayer reviews, signs and files personally on the filing page. Takes the filing session's continuationHandle, completedReturnPacketJson (the whole packet as one JSON string, in this server's packet schema) and packetSchemaSha256 (that schema's digest); any other argument, including a schema argument, is refused by name. The packet holds only facts the taxpayer stated in this chat and figures printed on documents the taxpayer gave in it; a fact the taxpayer has not stated is left out rather than written as no, none or 0, and a required fact left out comes back as its own blocker asking for the taxpayer's answer. The tax year is return.taxYear=2025 inside the packet. Returns status filing_session_ready with one filingSessionUrl when the packet is accepted: the only response that contains the link, which the taxpayer opens to give permission, review the return and sign it. Otherwise returns blockers, each with a path, a rule and a plain detail, and no link: that packet is not kept, every blocker that can be checked arrives in one response, a check that depends on a missing or refused answer runs once that answer is corrected, and the same handle accepts a corrected packet. The packet is accepted, and on the packet-first order the filing link issued, only when it holds every item the return and the filing page need from this conversation, the agentIdentity section included (where the link came first, the filing page waits for that accepted packet); each missing item comes back as its own blocker naming its path and the exact question for the taxpayer, all in one response, and only what the law has the taxpayer enter personally, the review and the signature are left for the filing page. A link that expires or is left unfinished costs nothing, since nothing is filed or charged until the taxpayer signs, and the same packet sent again with a new filing session's handle returns a fresh link in seconds; what the taxpayer already answered travels in the packet, so only the short filing page is done again. An accepted packet is held until the taxpayer gives permission on the filing page; declining there, or expiry, erases it. Federal only: no state, territory or local return is filed. The return has no taxpayer identity fields: the taxpayer's own details go only in the packet's separate, required agentIdentity section, which the filing page shows for the taxpayer to confirm. Business identifiers printed on each source form, such as an employer's or payer's name and EIN, are packet fields.

Starts a filing session when the taxpayer asks to file a US federal individual income tax return. Needs no arguments, receives no tax facts and returns a continuationHandle, which identifies this filing session in later calls. The one link is returned when the service accepts the complete packet. A new filing session is also how a fresh link replaces one that expired or was left unfinished, which filed and charged nothing: the same packet sent on the new handle returns it in seconds. Federal only: covers the US federal individual return and no state or local return. What can be filed: one original TY2025 federal Form 1040 or 1040-SR, or a tax year 2025 Form 1040-SS for a single bona fide resident of Puerto Rico with no Form 1040 filing requirement who owes self-employment tax on Schedule C business profit (net self-employment earnings of $400 or more), with no other income, credits, wages, estimated tax, or farm, partnership or church self-employment income, or a tax year 2025 Form 1040-NR for a single nonresident alien who has not at any time been a U.S. citizen or green card holder, with only U.S.-source effectively connected wages from one Form W-2, or Schedule C business income, partnership income on Schedule E Part II and self-employment tax, and no deduction, treaty benefit, dependent or credit, a refund by check or a balance settled outside the return; its Schedule OI answers go in the same packet as the return; no state or local return, amendment or extension. Accepted situations include W-2 wages (with the Form 2555 foreign earned income exclusion), 1099-INT and 1099-DIV with Schedule B, the foreign tax credit on dividends, some 1099-B/1099-DA sales, 1099-G, 1099-C (with the Form 982 bankruptcy, insolvency or principal residence exclusion), 1099-R with the Form 5329 additional taxes and Form 8606 IRA basis and Roth conversions, SSA-1099, W-2G, rental and royalty income (2025-placed rental depreciation and vehicle expenses on each rental's own Form 4562), some K-1 income, up to five Schedule C sole proprietorships (either spouse on a joint return) with Schedule SE and Form 1099-NEC, the self-employed health insurance deduction (Form 7206) and one SEP, SIMPLE IRA or solo 401(k) per person, head of household, some HSA (Form 8889), Archer or Medicare Advantage MSA distributions (Form 8853, filingChoices.form8853), Additional Medicare Tax, educator expenses, the residential clean energy credit, the clean vehicle credit for one new personal-use vehicle (Form 8936), the Lifetime Learning Credit, the refueling property credit (Form 8911), household employment taxes (Schedule H Part I, no federal unemployment tax), unreported tips (Form 4137, with Form 8959 above the threshold), Form 1099-NEC compensation reported as wages (Form 8919), dependents with the Child Tax Credit, Additional Child Tax Credit, Credit for Other Dependents and Earned Income Credit, the dependent care credit for children under 13, Form 8862 after an earlier-year disallowance, a decedent's return (a joint return signed by the surviving spouse, whose primary may be the spouse who died via filingChoices.jointReturnSignerFacts.primaryTaxpayerDied, or a single, head of household or married filing separately return signed by the personal representative, via filingChoices.decedentReturnSignerFacts, with a refund on Form 1310 via filingChoices.form1310), married filing separately in a community property state with wages, interest, dividends, one sole proprietorship, Schedule D Exception 1 sales and capital gain distributions, fully taxable pensions and the filer's own IRA and SSA-1099 benefits (Form 8958, filingChoices.communityPropertyAllocation), a cash-method Schedule F farm with a profit or an at-risk, materially participated loss and a profitable Form 4835 farm rental (each with the Form 8995 qualified business income deduction when all of its profit is qualified business income), Schedule 1-A deductions, standard or itemized deductions, student-loan interest, the qualified business income deduction (Form 8995; Form 8995-A for one Schedule C business and Schedule K-1 trades above the threshold, a business loss or prior-year loss netted on its Schedule C), the American Opportunity Credit at the taxpayer's own Form 8863 amounts, the Saver's Credit, the premium tax credit (Form 8962), Net Investment Income Tax (Form 8960), K-1 returns included, Form 8615, estimated payments, and a refund or balance due (electronic funds withdrawal and Form 9465 included). Refused today: an EIC needing a disability answer, a Form 8862 child born or died in 2025, a dependent care credit for anyone 13 or older, Form RRB-1099-R, a Form 1098-T source form, a decedent's refund with a court-appointed representative, a joint return whose two spouses both died, community property married filing separately beyond allocated wages, interest, dividends, one business, covered sales and pensions, on a rental, section 179, a depreciated vehicle or 2025 amortization, a zero-profit Schedule C, a Schedule C loss without material participation or needing Form 6198, more than one business beside section 179 in two of them, statutory-employee income, Form 4361, Schedule C tips, Schedule F or Form 4835, the self-employed health insurance or retirement deduction beside the owner's own Schedule F, a K-1 or Marketplace coverage credits, a second plan of either kind for one person, and on Schedule C depletion (line 12), employee benefit programs (line 14) and the energy efficient commercial buildings deduction (line 27a). Blind, 65-or-older and no-one-can-claim-as-dependent are each required as an explicit answer; a blank is not read as no.

Takes the filing session's continuationHandle. Returns the packet schema a completed return packet is checked against (the packet holds no Social Security number, ITIN or PIN: the taxpayer types those on the filing page): requestPacketSchema=true returns the schema digest (packetSchemaSha256, sent with the completed packet), an outline whose larger parts are named sections, the section list and the packetStarterTemplates list; packetSchemaSection=<name> returns one section and packetStarterTemplate=<id> one complete starter packet, in which each taxpayer-specific value is the placeholder REPLACE_WITH_TAXPAYER_VALUE, refused by path until replaced, with its askTheTaxpayer messages (the questions for the taxpayer) and each preset answer listed in presets with how it is settled. Read-only: no tax facts are sent here and no return is written. The tax year is return.taxYear=2025 inside the packet, not a tool argument; any other argument is refused by name.