Tax

The hanzo tax commands.

Also for this capability: API · CLI · MCP · SDKs

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.

API reference →

hanzo tax w9 list

Every command takes --json for the raw response and --help for its own flags. Sign in once with hanzo auth login; the commands below use that session, and the org they act in is the one it carries.

Command	What it does
`hanzo tax payments`	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.

Filings

Command	What it does
`hanzo tax filings create`	Exports the caller org's return for a tax year and form, as the files the IRIS Taxpayer Portal takes, and records the export.
`hanzo tax filings get <id>`	Reads one IRS return export WITH its files, rebuilt from the sealed forms and proven identical to what was exported.
`hanzo tax filings list`	Lists the caller org's IRS return exports and where each stands, without their files.
`hanzo tax filings receipt <id>`	Records what IRIS answered for an exported return — the Receipt ID on submission, then the acknowledgment.

Forms

Command	What it does
`hanzo tax forms correct <id>`	Corrects a furnished (or owed) 1099 with a NEW form that supersedes it.
`hanzo tax forms create`	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.
`hanzo tax forms furnish <id>`	Furnishes Copy B of a reviewed 1099 to its payee.
`hanzo tax forms get <id>`	Reads one 1099 the caller org prepared as payer, every box and both parties, TINs masked.
`hanzo tax forms list`	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.
`hanzo tax forms mailed <id>`	Records that the payer mailed a paper Copy B it owed.
`hanzo tax forms pdf <id>`	Download a 1099 the org prepared, as a PDF
`hanzo tax forms review <id>`	Marks a draft 1099 reviewed — a person has checked it.
`hanzo tax forms void <id>`	Voids a draft or reviewed 1099, which is then never furnished or filed.

Inbox

Command	What it does
`hanzo tax inbox get <id>`	Reads one Copy B furnished to the caller org.
`hanzo tax inbox list`	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.
`hanzo tax inbox pdf <id>`	Download a Copy B furnished to the org, as a PDF

Profile

Command	What it does
`hanzo tax profile certify`	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.
`hanzo tax profile get`	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.
`hanzo tax profile replace`	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.

W9

Command	What it does
`hanzo tax w9 create`	Asks another org for its W-9, as the org that pays it.
`hanzo tax w9 decline <id>`	Declines a request for this org's W-9.
`hanzo tax w9 get <id>`	Reads one W-9 relationship from the caller's side.
`hanzo tax w9 grant <id>`	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.
`hanzo tax w9 list`	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.
`hanzo tax w9 match <id>`	Records the result of IRS TIN Matching for a payee, as the payer.
`hanzo tax w9 revoke <id>`	Revokes a W-9 this org granted.
`hanzo tax w9 tin <id>`	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.

Was this page useful?

Broken link or missing step? Drop it in #docs on Discord or open a PR.

PreviousPrincipal NextPlatform