# Tax URL: https://docs.hanzo.ai/docs/cli/tax > The `hanzo tax` commands. Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/tax) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/tax) · [SDKs](https://docs.hanzo.ai/docs/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 →](https://docs.hanzo.ai/docs/openapi/tax) ```bash 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 ` | 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 ` | 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 ` | 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 ` | Furnishes Copy B of a reviewed 1099 to its payee. | | `hanzo tax forms get ` | 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 ` | Records that the payer mailed a paper Copy B it owed. | | `hanzo tax forms pdf ` | Download a 1099 the org prepared, as a PDF | | `hanzo tax forms review ` | Marks a draft 1099 reviewed — a person has checked it. | | `hanzo tax forms void ` | Voids a draft or reviewed 1099, which is then never furnished or filed. | ### Inbox | Command | What it does | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `hanzo tax inbox get ` | 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 ` | 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 ` | Declines a request for this org's W-9. | | `hanzo tax w9 get ` | Reads one W-9 relationship from the caller's side. | | `hanzo tax w9 grant ` | 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 ` | Records the result of IRS TIN Matching for a payee, as the payer. | | `hanzo tax w9 revoke ` | Revokes a W-9 this org granted. | | `hanzo tax w9 tin ` | 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. |