{"name":"tax","stage":"ga","description":"Package tax is how companies formed on Hanzo exchange W-9s, W-8s and 1099s with each other, from the payments that moved between them on Hanzo's rails.","operations":[{"operationId":"get_tax_filings","method":"GET","href":"/v1/tax/filings","summary":"Lists the caller org's IRS return exports and where each stands, without their files."},{"operationId":"post_tax_filings","method":"POST","href":"/v1/tax/filings","summary":"Exports the caller org's return for a tax year and form, as the files the IRIS Taxpayer Portal takes, and records the export."},{"operationId":"get_tax_filings_by_id","method":"GET","href":"/v1/tax/filings/{id}","summary":"Reads one IRS return export WITH its files, rebuilt from the sealed forms and proven identical to what was exported."},{"operationId":"post_tax_filings_by_id_receipt","method":"POST","href":"/v1/tax/filings/{id}/receipt","summary":"Records what IRIS answered for an exported return — the Receipt ID on submission, then the acknowledgment."},{"operationId":"get_tax_forms","method":"GET","href":"/v1/tax/forms","summary":"Lists the 1099s the caller org prepared as payer, oldest first, voided and superseded ones included — a return that was furnished stays on the record."},{"operationId":"post_tax_forms","method":"POST","href":"/v1/tax/forms","summary":"Prepares the caller org's 1099 drafts for a tax year, as the PAYER: one 1099-NEC and/or 1099-MISC per payee whose reportable payments on Hanzo's rails reach the year's threshold, from the same derivation GET /v1/tax/payments answers."},{"operationId":"get_tax_forms_by_id","method":"GET","href":"/v1/tax/forms/{id}","summary":"Reads one 1099 the caller org prepared as payer, every box and both parties, TINs masked."},{"operationId":"post_tax_forms_by_id_correct","method":"POST","href":"/v1/tax/forms/{id}/correct","summary":"Corrects a furnished (or owed) 1099 with a NEW form that supersedes it."},{"operationId":"post_tax_forms_by_id_furnish","method":"POST","href":"/v1/tax/forms/{id}/furnish","summary":"Furnishes Copy B of a reviewed 1099 to its payee."},{"operationId":"post_tax_forms_by_id_mailed","method":"POST","href":"/v1/tax/forms/{id}/mailed","summary":"Records that the payer mailed a paper Copy B it owed."},{"operationId":"get_tax_forms_by_id_pdf","method":"GET","href":"/v1/tax/forms/{id}/pdf","summary":"Download a 1099 the org prepared, as a PDF"},{"operationId":"post_tax_forms_by_id_review","method":"POST","href":"/v1/tax/forms/{id}/review","summary":"Marks a draft 1099 reviewed — a person has checked it."},{"operationId":"post_tax_forms_by_id_void","method":"POST","href":"/v1/tax/forms/{id}/void","summary":"Voids a draft or reviewed 1099, which is then never furnished or filed."},{"operationId":"get_tax_inbox","method":"GET","href":"/v1/tax/inbox","summary":"Lists the Copy B statements furnished to the caller org — every 1099 a payer on Hanzo delivered to it electronically, corrected ones beside the ones they supersede."},{"operationId":"get_tax_inbox_by_id","method":"GET","href":"/v1/tax/inbox/{id}","summary":"Reads one Copy B furnished to the caller org."},{"operationId":"get_tax_inbox_by_id_pdf","method":"GET","href":"/v1/tax/inbox/{id}/pdf","summary":"Download a Copy B furnished to the org, as a PDF"},{"operationId":"get_tax_payments","method":"GET","href":"/v1/tax/payments","summary":"Returns the caller org's tax year as a PAYER: every payment it made to another org in that calendar year, on any rail, as the event plane records it, each classified — reportable or not, in which 1099 box, and the rule that decided it, with its source — and each payee's totals tested against the year's threshold."},{"operationId":"get_tax_profile","method":"GET","href":"/v1/tax/profile","summary":"Returns the caller org's own tax profile — every line of its Form W-9, W-8BEN or W-8BEN-E, every number masked to its last four characters, where the certification stands, whether a W-8 is valid and when it expires, and whether the org consents to receive its 1099s electronically."},{"operationId":"put_tax_profile","method":"PUT","href":"/v1/tax/profile","summary":"Writes the caller org's tax profile — its Form W-9, or its Form W-8BEN or W-8BEN-E when it is a foreign person — and answers it, every number masked."},{"operationId":"post_tax_profile_certify","method":"POST","href":"/v1/tax/profile/certify","summary":"Signs the caller org's certification — Form W-9 Part II, Form W-8BEN Part III or Form W-8BEN-E Part XXX — through /v1/legal's e-signature."},{"operationId":"get_tax_w9","method":"GET","href":"/v1/tax/w9","summary":"Lists the caller org's W-9 relationships on both sides: the W-9s it asked its payees for, with where each stands, and the requests other orgs made for its own W-9."},{"operationId":"post_tax_w9","method":"POST","href":"/v1/tax/w9","summary":"Asks another org for its W-9, as the org that pays it."},{"operationId":"get_tax_w9_by_id","method":"GET","href":"/v1/tax/w9/{id}","summary":"Reads one W-9 relationship from the caller's side."},{"operationId":"post_tax_w9_by_id_decline","method":"POST","href":"/v1/tax/w9/{id}/decline","summary":"Declines a request for this org's W-9."},{"operationId":"post_tax_w9_by_id_grant","method":"POST","href":"/v1/tax/w9/{id}/grant","summary":"Grants the payer that asked a live read of this org's W-9 — every line, the TIN masked, and the full TIN to that payer's org admins alone, each read audited."},{"operationId":"post_tax_w9_by_id_match","method":"POST","href":"/v1/tax/w9/{id}/match","summary":"Records the result of IRS TIN Matching for a payee, as the payer."},{"operationId":"post_tax_w9_by_id_revoke","method":"POST","href":"/v1/tax/w9/{id}/revoke","summary":"Revokes a W-9 this org granted."},{"operationId":"get_tax_w9_by_id_tin","method":"GET","href":"/v1/tax/w9/{id}/tin","summary":"Reads a payee's TIN in full — and, for a payee on a W-8, its foreign TIN, which the payer's Form 1042-S carries."}],"_links":{"describedby":{"href":"/v1/openapi.json?capability=tax"},"self":{"href":"/v1/tax"},"up":{"href":"/v1"}}}